Skip to content

Self-Hosted Configuration Options

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

autodiscover

Autodiscover all repositories

Name Value
type boolean
default false

Be cautious when using this option - it will run Renovate over every repository that the bot account has access to. To filter this list, use autodiscoverFilter.

autodiscoverFilter

Filter the list of autodiscovered repositories

Name Value
type string

A minimatch glob-style pattern for filtering autodiscovered repositories. Ex: project/*

baseDir

The base directory for Renovate to store local files, including repository files and cache. If left empty, Renovate will create its own temporary directory to use.

Name Value
type string
default null

Configure this directory if you want to change which directory Renovate uses for storing data. If left unconfigured, it will typically be a temporary directory like /tmp/renovate/.

binarySource

Where to source binaries like npm and yarn from, choices are bundled, global and docker

Name Value
type string
default "bundled"

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

cacheDir

The directory for Renovate for storing caches. If left empty, Renovate will create a subdirectory within baseDir to use.

Name Value
type string
default null

Configure this directory if you want to change which directory Renovate uses for storing cache data. If left unconfigured, it will typically be a temporary directory like /tmp/renovate/cache/. If you configure this to be different to the baseDir, it means you can have one location for repo data and another for cache data.

dockerMapDotfiles

Map relevant home directory dotfiles into containers when binarySource=docker.

Name Value
type boolean
default false

This is used if you want to map "dotfiles" from your host computer home directory to containers that Renovate creates, e.g. for updating lock files. Currently applicable to .npmrc only.

dockerUser

Specify UID and GID for docker-based binaries when binarySource=docker is used.

Name Value
type string
default null

Override default user and group used by docker-based binaries. UID and GID should match the user that executes renovate. See Docker run reference for more information on user and group syntax. Set this to 1001:1002 to use UID 1001 and GID 1002.

dryRun

If enabled, perform a dry run by logging messages instead of creating/updating/deleting branches and PRs

Name Value
type boolean
default false

endpoint

Custom endpoint to use

Name Value
type string

force

Any configuration defined within this object will force override existing settings

Name Value
type object

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

Whether CLI configuration options should be moved to the force config section

Name Value
type boolean
default true

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. It will also override any settings in packageRules.

forkMode

Set to true to fork the source repository and create branches there instead

Name Value
type boolean
default false

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

gitAuthor

Author to use for git commits. RFC5322

Name Value
type string
default null

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

gitPrivateKey

PGP key to use for signing git commits

Name Value
type string
default null

logFile

Log file path

Name Value
type string
default null

logFileLevel

Log file log level

Name Value
type string
default "debug"

logLevel

Logging level

Name Value
type string
allowedValues fatal,error,warn,info,debug,trace
default "info"

onboarding

Require a Configuration PR first

Name Value
type boolean
default true

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.

onboardingBranch

Change this value in order to override the default onboarding branch name.

Name Value
type string
default "renovate/configure"

Note that this setting is independent of branchPrefix. For example, if you configure branchPrefix to be renovate- then you'd still have the onboarding PR created with branch renovate/configure until you configure onboardingBranch=renovate-configure or similar. If you have an existing Renovate installation and you change onboardingBranch then it's possible that you'll get onboarding PRs for repositories that had previously closed the onboarding PR unmerged.

onboardingConfig

Configuration to use in onboarding PRs

Name Value
type object
mergeable true

onboardingPrTitle

Change this value in order to override the default onboarding PR title.

Name Value
type string
default "Configure Renovate"

Similarly to onboardingBranch, if you have an existing Renovate installation and you change onboardingPrTitle then it's possible that you'll get onboarding PRs for repositories that had previously closed the onboarding PR unmerged.

optimizeForDisabled

Set to true to first check for disabling in config before cloning

Name Value
type boolean
default false

password

Password for authentication. Currently Bitbucket only (AppPassword).

Name Value
type string
default null

persistRepoData

If set to true, repository data will preserved between runs instead of deleted.

Name Value
type boolean
default false

Set this to true if you wish for Renovate to persist repo data between runs. The intention is that this allows Renovate to do a faster git fetch between runs rather than git clone. It also may mean that ignored directories like node_modules can be preserved and save time on operations like npm install.

platform

Platform type of repository

Name Value
type string
allowedValues azure,bitbucket,bitbucket-server,github,gitlab
default "github"

prCommitsPerRunLimit

Set a maximum number of commits per Renovate run. Default is no limit.

Name Value
type integer
default 0

Parameter to reduce CI load. CI jobs are usually triggered by these events: pull-request creation, pull-request update, automerge events. Set as an integer. Default is no limit.

prFooter

Pull Request footer template

Name Value
type string
default "This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate)."

printConfig

If enabled, log the full resolved config for each repo, including resolved presets

Name Value
type boolean
default false

This option is useful for troubleshooting, particularly if using presets. e.g. run renovate foo/bar --print-config > config.log and the fully-resolved config will be included in the log file.

privateKey

Server-side private key

Name Value
type string
replaceLineReturns true
default null

Links which are embedded within PRs, issues, etc

Name Value
type object
mergeable true
additionalProperties [object Object]

Override this object if you wish to change the URLs that Renovate links to, e.g. if you have an internal forum for asking for help.

repositories

List of Repositories

Name Value
type array

requireConfig

Set to true if repositories must have a config to activate.

Name Value
type boolean
default true

skipInstalls

Skip installing modules/dependencies if lock file updating is possible alone

Name Value
type boolean
default null

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

Repository Auth Token

Name Value
type string
default null

trustLevel

Set this to "high" if the bot should trust the repository owners/contents

Name Value
type string
default "low"

Setting trustLevel to "high" can make sense in many self-hosted cases where the bot operator trusts the content in each repository.

Setting trustLevel=high means:

  • Child processes are run with full access to env
  • .npmrc files can have environment variable substitution performed

username

Username for authentication. Currently Bitbucket only

Name Value
type string
default null