aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/usage/config-overview.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/usage/config-overview.md')
-rw-r--r--docs/usage/config-overview.md24
1 files 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.
<!-- prettier-ignore -->
!!! note