Skip to content

docs: document MISE_ENV behavior for global/system configs#6385

Merged
jdx merged 1 commit intomainfrom
doc
Sep 23, 2025
Merged

docs: document MISE_ENV behavior for global/system configs#6385
jdx merged 1 commit intomainfrom
doc

Conversation

@jdx
Copy link
Owner

@jdx jdx commented Sep 23, 2025

No description provided.

Copilot AI review requested due to automatic review settings September 23, 2025 00:34
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances the documentation to clarify how MISE_ENV affects configuration file resolution at different scopes. The changes add detailed information about environment-specific configuration files that can be used at system, user, and project levels.

Key Changes

  • Documents environment-specific config file patterns (config.<env>.toml, mise.<env>.toml)
  • Adds information about configuration fragments in conf.d/ directories
  • Clarifies the complete hierarchy of configuration files with their precedence

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@github-actions
Copy link

xtasks/test/perf

Command mise-2025.9.15 mise Variance
install (cached) 171ms ✅ 105ms +62%
ls (cached) 64ms 63ms +1%
bin-paths (cached) 70ms 70ms +0%
task-ls (cached) 485ms 489ms +0%

✅ Performance improvement: install cached is 62%

@jdx jdx merged commit 2304b54 into main Sep 23, 2025
19 of 20 checks passed
@jdx jdx deleted the doc branch September 23, 2025 01:03
@jdx jdx mentioned this pull request Sep 23, 2025
jdx added a commit that referenced this pull request Sep 24, 2025
### 🚀 Features

- **(java)** add support for Liberica NIK releases by @roele in
[#6382](#6382)

### 🐛 Bug Fixes

- **(toolset)** handle underflow in version_sub function by @koh-sh in
[#6389](#6389)

### 📚 Documentation

- document MISE_ENV behavior for global/system configs by @jdx in
[#6385](#6385)

### New Contributors

- @jc00ke made their first contribution in
[#6386](#6386)
- @koh-sh made their first contribution in
[#6389](#6389)

Co-authored-by: mise-en-dev <release@mise.jdx.dev>
netbsd-srcmastr pushed a commit to NetBSD/pkgsrc that referenced this pull request Sep 25, 2025
## [2025.9.18](https://github.com/jdx/mise/compare/v2025.9.17..v2025.9.18) - 2025-09-24

### 📦 Registry

- replace amplify-cli github backend with ubi by @eggplants in [#6396](jdx/mise#6396)

### 🚀 Features

- **(template)** add read_file() function by @jdx in [#6400](jdx/mise#6400)

### 🐛 Bug Fixes

- **(aqua)** support github_artifact_attestations.enabled by @risu729 in [#6372](jdx/mise#6372)
- use /c instead of -c on windows in postinstall hook by @risu729 in [#6397](jdx/mise#6397)

### 🧪 Testing

- **(test-tool)** uninstall all versions and clear cache before installation by @jdx in [#6393](jdx/mise#6393)

### New Contributors

- @eggplants made their first contribution in [#6396](jdx/mise#6396)

## [2025.9.17](https://github.com/jdx/mise/compare/v2025.9.16..v2025.9.17) - 2025-09-24

### 🚀 Features

- **(java)** add support for Liberica NIK releases by @roele in [#6382](jdx/mise#6382)

### 🐛 Bug Fixes

- **(toolset)** handle underflow in version_sub function by @koh-sh in [#6389](jdx/mise#6389)

### 📚 Documentation

- document MISE_ENV behavior for global/system configs by @jdx in [#6385](jdx/mise#6385)

### New Contributors

- @jc00ke made their first contribution in [#6386](jdx/mise#6386)
- @koh-sh made their first contribution in [#6389](jdx/mise#6389)
riastradh pushed a commit to riastradh/pkgsrc-test20250901 that referenced this pull request Feb 8, 2026
## [2025.9.18](https://github.com/jdx/mise/compare/v2025.9.17..v2025.9.18) - 2025-09-24

### 📦 Registry

- replace amplify-cli github backend with ubi by @eggplants in [#6396](jdx/mise#6396)

### 🚀 Features

- **(template)** add read_file() function by @jdx in [#6400](jdx/mise#6400)

### 🐛 Bug Fixes

- **(aqua)** support github_artifact_attestations.enabled by @risu729 in [#6372](jdx/mise#6372)
- use /c instead of -c on windows in postinstall hook by @risu729 in [#6397](jdx/mise#6397)

### 🧪 Testing

- **(test-tool)** uninstall all versions and clear cache before installation by @jdx in [#6393](jdx/mise#6393)

### New Contributors

- @eggplants made their first contribution in [#6396](jdx/mise#6396)

## [2025.9.17](https://github.com/jdx/mise/compare/v2025.9.16..v2025.9.17) - 2025-09-24

### 🚀 Features

- **(java)** add support for Liberica NIK releases by @roele in [#6382](jdx/mise#6382)

### 🐛 Bug Fixes

- **(toolset)** handle underflow in version_sub function by @koh-sh in [#6389](jdx/mise#6389)

### 📚 Documentation

- document MISE_ENV behavior for global/system configs by @jdx in [#6385](jdx/mise#6385)

### New Contributors

- @jc00ke made their first contribution in [#6386](jdx/mise#6386)
- @koh-sh made their first contribution in [#6389](jdx/mise#6389)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants