Skip to content

Config Validation

You can check your Renovate configuration with a standalone program called renovate-config-validator. All renovate distributions include this program.

Default behavior

When you run renovate-config-validator with no arguments it will check:

  • all default locations (if files exist)
  • the RENOVATE_CONFIG_FILE environment variable

For example:

$ npm install --global renovate
added 750 packages, and audited 751 packages in 51s
$ renovate-config-validator
 INFO: Validating renovate.json
 INFO: Config validated successfully

Strict mode

By default, the validator program fails with a non-zero exit code if there are any validation warnings or errors. You can pass the --strict flag to make it fail if a scanned config needs migration.

Pass file to check as CLI arguments

You can pass the file you want to check to the renovate-config-validator program with a CLI argument. This can be handy to check a config file with a non-default name, like when you're using preset repositories. For example:

$ npm install --global renovate
added 750 packages, and audited 751 packages in 51s
$ renovate-config-validator first_config.jsonn
 INFO: Validating first_config_.json
 INFO: Config validated successfully

Validate your config automatically

You can create a pre-commit hook to validate your configuration automatically. Go to the renovatebot/pre-commit-hooks repository for more information.