From bf17df930e796d9c3e63889a63d586bad5a757c1 Mon Sep 17 00:00:00 2001 From: jdx <216188+jdx@users.noreply.github.com> Date: Mon, 22 Sep 2025 19:34:16 -0500 Subject: [PATCH] docs: document MISE_ENV behavior for global/system configs --- docs/configuration.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/configuration.md b/docs/configuration.md index f8ae4e7fbf..e30f8eb550 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -47,14 +47,24 @@ When mise needs configuration, it follows this process: ``` / -├── etc/mise/config.toml # System-wide config (highest precedence) +├── etc/mise/ # System-wide config (highest precedence) +│ ├── conf.d/*.toml # System fragments, loaded alphabetically +│ ├── config.toml # System defaults +│ └── config..toml # Env-specific system config (MISE_ENV or -E) └── home/user/ - ├── .config/mise/config.toml # Global user config + ├── .config/mise/ + │ ├── conf.d/*.toml # User fragments, loaded alphabetically + │ ├── config.toml # Global user config + │ ├── config..toml # Env-specific user config + │ ├── config.local.toml # User-local overrides + │ └── config..local.toml # Env-specific user-local overrides └── work/ ├── mise.toml # Work-wide settings └── myproject/ ├── mise.local.toml # Local overrides (git-ignored) ├── mise.toml # Project config + ├── mise..toml # Env-specific project config + ├── mise..local.toml # Env-specific project local overrides └── backend/ └── mise.toml # Service-specific config (lowest precedence) ```