@@ -154,7 +154,7 @@ If the "development branch" is configured but the branch itself does not exist (
...
@@ -154,7 +154,7 @@ If the "development branch" is configured but the branch itself does not exist (
## binarySource
## binarySource
Renovate often needs to use third-party binaries in its PRs, like `npm` to update `package-lock.json` or `go` to update `go.sum`.
Renovate often needs to use third-party tools in its PRs, like `npm` to update `package-lock.json` or `go` to update `go.sum`.
By default, Renovate uses a child process to run such tools, so they must be:
By default, Renovate uses a child process to run such tools, so they must be:
- installed before running Renovate
- installed before running Renovate
...
@@ -165,36 +165,9 @@ For this to work, `docker` needs to be installed and the Docker socket available
...
@@ -165,36 +165,9 @@ For this to work, `docker` needs to be installed and the Docker socket available
Now Renovate uses `docker run` to create containers like Node.js or Python to run tools in as-needed.
Now Renovate uses `docker run` to create containers like Node.js or Python to run tools in as-needed.
Additionally, when Renovate is run inside a container built using [`containerbase`](https://github.com/containerbase), such as the official Renovate images on Docker Hub, then `binarySource=install` can be used.
Additionally, when Renovate is run inside a container built using [`containerbase`](https://github.com/containerbase), such as the official Renovate images on Docker Hub, then `binarySource=install` can be used.
This mode means that Renovate will dynamically install the version of tools available, if supported.
This mode means that Renovate will dynamically install the desired version of each tool needed.
Supported tools for dynamic install are:
If all projects are managed by Hermit, you can tell Renovate to use the tool versions specified in each project via Hermit by setting `binarySource=hermit`.
-`bundler`
-`cargo`
-`composer`
-`dotnet`
-`flux`
-`golang`
-`gradle-wrapper`
-`helm`
-`jb`
-`jsonnet-bundler`
-`lerna`
-`mix`
-`node`
-`npm`
-`pip_requirements`
-`pip-compile`
-`pipenv`
-`pnpm`
-`poetry`
-`python`
-`rust`
-`yarn`
If all projects are managed by Hermit, you can tell Renovate to use the tooling versions specified in each project via Hermit by setting `binarySource=hermit`.
Tools not on this list fall back to `binarySource=global`.
## cacheDir
## cacheDir
...
@@ -359,7 +332,7 @@ Now when Renovate pulls a new `sidecar` image, the final image is `ghcr.io/conta
...
@@ -359,7 +332,7 @@ Now when Renovate pulls a new `sidecar` image, the final image is `ghcr.io/conta
## dockerUser
## dockerUser
Override default user and group used by Docker-based binaries.
Override default user and group used by Docker-based tools.
The user-id (UID) and group-id (GID) must match the user that executes Renovate.
The user-id (UID) and group-id (GID) must match the user that executes Renovate.
Read the [Docker run reference](https://docs.docker.com/engine/reference/run/#user) for more information on user and group syntax.
Read the [Docker run reference](https://docs.docker.com/engine/reference/run/#user) for more information on user and group syntax.