Config Environments

[jylenhof]

When I look at this page :
https://mise.jdx.dev/configuration/environments.html, it seems that only these configurations are allowed :

    mise.{MISE_ENV}.local.toml
    mise.local.toml
    mise.{MISE_ENV}.toml
    mise.toml

But If I look here https://mise.jdx.dev/configuration.html#mise-toml it seems this is also possible :
.mise.{MISE_ENV}.toml with a dot at first

It is not clear to me what files are really allowed and in which order there are handled

Second thing I found curious, when doing mise use -g tool@latest, mise add this to mise.{MISE_ENV}.toml file and not to mise.toml (or even the .config/mise/mise.toml file)... Is it a bug ?

[arcticShadow]

The way I read it -
Is that the https://mise.jdx.dev/configuration.html page shows all possible places that a config file can be located.

And my interpretation of https://mise.jdx.dev/configuration/environments.html is that you can place a environment file, anywhere that the top level mise config files can be placed.

One way to document this clearer may be to identify the directory in which mise files can be placed, and the naming pattern in each directory.

i.e. (generated this list from an LLM as i couldn't be bothered typing and extrapolating it)

Current directory and parent directories can contain:

• mise.{ENV}.local.toml
• mise.local.toml
• mise.{ENV}.toml
• mise.toml
• .mise.{ENV}.local.toml
• .mise.local.toml
• .mise.{ENV}.toml
• .mise.toml

Current directory and parent directories can also have these paths:

• mise/config.{ENV}.local.toml
• mise/config.local.toml
• mise/config.{ENV}.toml
• mise/config.toml
• .mise/config.{ENV}.local.toml
• .mise/config.local.toml
• .mise/config.{ENV}.toml
• .mise/config.toml

Current directory and parent directories can also have these paths:

• .config/mise.{ENV}.local.toml
• .config/mise.local.toml
• .config/mise.{ENV}.toml
• .config/mise.toml
• .config/mise/config.{ENV}.local.toml
• .config/mise/config.local.toml
• .config/mise/config.{ENV}.toml
• .config/mise/config.toml

Global config locations:

• ~/.config/mise/config.toml
• ~/.config/mise/conf.d/*.toml (all files in directory loaded alphabetically)

System config location:

• /etc/mise/config.toml

Key notes:

• {ENV} represents environment names like "development", "production", etc
• Multiple environments can be specified with comma separation like "ci,test"
• .local.toml files are meant for local-only config not committed to version control
• Files higher in directory tree override lower ones
• Within same directory, more specific env files override less specific ones