From 8796843a221956a2fa66dc7c127bf78adf17e4a1 Mon Sep 17 00:00:00 2001 From: KUGA2 <10581931+KUGA2@users.noreply.github.com> Date: Tue, 17 Dec 2024 06:22:51 +0100 Subject: docs(config-overview.md): explain order of operations for final config (#32623) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Rhys Arkins Co-authored-by: Birger J. Nordølum Co-authored-by: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com> --- docs/usage/config-overview.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/docs/usage/config-overview.md b/docs/usage/config-overview.md index 669e15ea876..b627789ba3e 100644 --- a/docs/usage/config-overview.md +++ b/docs/usage/config-overview.md @@ -1,12 +1,24 @@ # Renovate configuration overview -When Renovate runs on a repository, the final config used is derived from the: +Each time Renovate runs on a repository it reads the configuration files listed below and creates a final config. +This final config describes what Renovate will do during its run. -- Default config -- Global config -- Inherited config -- Repository config -- Resolved presets referenced in config +The final config is internal to Renovate, and is _not_ saved or cached for a later run. +But you can always find the final config in Renovate's logs. + +Renovate reads the configuration files in this order (from from top to bottom): + +1. Default config +2. Global config + - File config + - Environment config + - CLI config +3. Inherited config +4. Resolved presets referenced in config +5. Repository config + +Items with a higher number override items that have lower numbers. +If the item has the `mergeable` property, it will merge with lower numbers instead. !!! note -- cgit v1.2.3