Linux

Where Does mise Store Tools and Config?

mise data directory with installs plus config.toml settings on Linux.

Last updated

mise splits state two ways: tool installs and shims in the XDG data tree, settings and per-project version files in config files. The data directory is a cache you can always rebuild.

Version pins live in mise.toml or legacy .tool-versions files inside projects. Back up config.toml for global defaults and let installs redownload.

Where mise stores this, by platform

Linux
~/.local/share/mise

Holds installs per tool version, shims, downloads and lock tracking. Global settings live at ~/.config/mise/config.toml with per-project mise.toml files in repos. Prune old versions with mise prune. Copy both trees to migrate without redownloading.

Frequently asked questions

Where is the mise config file?

Global defaults in ~/.config/mise/config.toml, project pins in mise.toml files. Legacy .tool-versions files still work as fallback.

How do I free mise disk space?

Run mise prune to drop unused versions from the data directory above. Cache and downloads go with them.

Notice an outdated path? Let us know.