renovate/website/docs/self-hosted-configuration.md
Rhys Arkins 598d57c315 feat: binarySource
Defaulting to ‘bundled’ (default behaviour), this option can be changed to ‘global’ if you wish Renovate to use globally installed npm, yarn, pnpm and lerna binaries. Note: composer always uses global regardless.
2018-09-14 20:38:52 +02:00

2.6 KiB

title description
Self-Hosted Configuration Self-Hosted Configuration usable in renovate.json or package.json

Self-Hosted Configuration Options

The below configuration options are applicable only if you are running your own instance ("bot") of Renovate.

autodiscover

Be cautious when using this option - it will run Renovate over every repository that the bot account has access to.

binarySource

Set this to 'global' if you wish Renovate to use globally-installed binaries (npm, yarn, etc) instead of using its bundled versions.

endpoint

exposeEnv

force

This object is used as a "force override" when you need to make sure certain configuration overrides whatever is configured in the repository. For example, forcing a null (no) schedule to make sure Renovate raises PRs on a run even if the repository itself or its preset defines a schedule that's currently in active.

In practice, it is implemented by converting the force configuration into a packageRule that matches all packages.

forceCli

This is set to true by default, meaning that any settings (such as schedule) take maximum priority even against custom settings existing inside individual repositories.

forkMode

You probably have no need for this option - it is an experimental setting for the Renovate hosted GitHub App.

gitAuthor

RFC5322-compliant string if you wish to customise the git author for commits.

gitFs

This setting is experimental, and works for GitHub repositories only. If enabled, Renovate will git clone repos and use git for file operations such as creating branches and committing files.

gitPrivateKey

logFile

logFileLevel

logLevel

mirrorMode

You probably have no need for this option - it is an experimental setting for the Renovate hosted GitHub App.

onboarding

Set this to false if (a) you configure Renovate entirely on the bot side (i.e. empty renovate.json in repositories) and (b) you wish to run Renovate on every repository the bot has access to, and (c) you wish to skip the onboarding PRs.

onboardingConfig

password

platform

prFooter

privateKey

repositories

requireConfig

skipInstalls

By default, Renovate will use the most efficient approach to updating package files and lock files, which in most cases skips the need to perform a full module install by the bot. If this is set to false, then a full install of modules will be done. This is currently applicable to npm and lerna/npm only, and only used in cases where bugs in npm result in incorrect lock files being updated.

token

username