Installing Mise
If you are new to mise
, follow the Getting Started guide first.
Installation Methods
This page lists various ways to install mise
on your system.
https://mise.run
Note that it isn't necessary for mise
to be on PATH
. If you run the activate script in your shell's rc file, mise will automatically add itself to PATH
.
curl https://mise.run | sh
# or with options
curl https://mise.run | MISE_INSTALL_PATH=/usr/local/bin/mise sh
Options:
MISE_DEBUG=1
– enable debug loggingMISE_QUIET=1
– disable non-error outputMISE_INSTALL_PATH=/some/path
– change the binary path (default:~/.local/bin/mise
)MISE_VERSION=v2024.5.17
– install a specific version
If you want to verify the install script hasn't been tampered with:
gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 0x7413A06D
curl https://mise.jdx.dev/install.sh.sig | gpg --decrypt > install.sh
# ensure the above is signed with the mise release key
sh ./install.sh
or if you're allergic to | sh
:
curl https://mise.jdx.dev/mise-latest-macos-arm64 > ~/.local/bin/mise
chmod +x ~/.local/bin/mise
curl https://mise.jdx.dev/mise-latest-macos-x64 > ~/.local/bin/mise
chmod +x ~/.local/bin/mise
curl https://mise.jdx.dev/mise-latest-linux-x64 > ~/.local/bin/mise
chmod +x ~/.local/bin/mise
curl https://mise.jdx.dev/mise-latest-linux-arm64 > ~/.local/bin/mise
chmod +x ~/.local/bin/mise
It doesn't matter where you put it. So use ~/bin
, /usr/local/bin
, ~/.local/bin
or whatever.
Supported os/arch:
macos-x64
macos-arm64
linux-x64
linux-x64-musl
linux-arm64
linux-arm64-musl
linux-armv6
linux-armv6-musl
linux-armv7
linux-armv7-musl
If you need something else, compile it with cargo install mise
(see below).
apk
For Alpine Linux:
apk add mise
mise lives in the community repository.
apt
For installation on Ubuntu/Debian:
apt update -y && apt install -y gpg sudo wget curl
sudo install -dm 755 /etc/apt/keyrings
wget -qO - https://mise.jdx.dev/gpg-key.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/mise-archive-keyring.gpg 1> /dev/null
echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.gpg arch=amd64] https://mise.jdx.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/mise.list
sudo apt update
sudo apt install -y mise
apt update -y && apt install -y gpg sudo wget curl
sudo install -dm 755 /etc/apt/keyrings
wget -qO - https://mise.jdx.dev/gpg-key.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/mise-archive-keyring.gpg 1> /dev/null
echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.gpg arch=arm64] https://mise.jdx.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/mise.list
sudo apt update
sudo apt install -y mise
aur
For Arch Linux:
git clone https://aur.archlinux.org/mise.git
cd mise
makepkg -si
Cargo
Build from source with Cargo:
cargo install mise
Do it faster with cargo-binstall:
cargo install cargo-binstall
cargo binstall mise
Build from the latest commit in main:
cargo install mise --git https://github.com/jdx/mise --branch main
dnf
For Fedora, CentOS, Amazon Linux, RHEL and other dnf-based distributions:
dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://mise.jdx.dev/rpm/mise.repo
dnf install -y mise
Docker
docker run jdxcode/mise x node@20 -- node -v
Homebrew
brew install mise
npm
mise is available on npm as a precompiled binary. This isn't a Node.js package—just distributed via npm. This is useful for JS projects that want to setup mise via package.json
or npx
.
npm install -g @jdxcode/mise
Use npx if you just want to test it out for a single command without fully installing:
npx @jdxcode/mise exec [email protected] -- python some_script.py
GitHub Releases
Download the latest release from GitHub.
curl -L https://github.com/jdx/mise/releases/download/v2024.1.0/mise-v2024.1.0-linux-x64 > /usr/local/bin/mise
chmod +x /usr/local/bin/mise
MacPorts
sudo port install mise
nix
For the Nix package manager, at release 23.05 or later:
nix-env -iA mise
You can also import the package directly using mise-flake.packages.${system}.mise
. It supports all default Nix systems.
yum
yum install -y yum-utils
yum-config-manager --add-repo https://mise.jdx.dev/rpm/mise.repo
yum install -y mise
Windows
Download the latest release from GitHub and add the binary to your PATH.
If your shell does not support mise activate
, you would want to edit PATH to include the shims directory (by default: %LOCALAPPDATA%\mise\shims
).
Note that Windows support is very minimal for now.
Shells
Bash
echo 'eval "$(mise activate bash)"' >> ~/.bashrc
Zsh
echo 'eval "$(mise activate zsh)"' >> "${ZDOTDIR-$HOME}/.zshrc"
Fish
echo 'mise activate fish | source' >> ~/.config/fish/config.fish
TIP
For homebrew and possibly other installs mise is automatically activated so this is not necessary.
See MISE_FISH_AUTO_ACTIVATE=1
for more information.
Nushell
Nu does not support eval
Install Mise by appending env.nu
and config.nu
:
'
let mise_path = $nu.default-config-dir | path join mise.nu
^mise activate nu | save $mise_path --force
' | save $nu.env-path --append
"\nuse ($nu.default-config-dir | path join mise.nu)" | save $nu.config-path --append
If you prefer to keep your dotfiles clean you can save it to a different directory then update $env.NU_LIB_DIRS
:
"\n$env.NU_LIB_DIRS ++= ($mise_path | path dirname | to nuon)" | save $nu.env-path --append
Xonsh
Since .xsh
files are not compiled you may shave a bit off startup time by using a pure Python import: add the code below to, for example, ~/.config/xonsh/mise.py
config file and import mise
it in ~/.config/xonsh/rc.xsh
:
from pathlib import Path
from xonsh.built_ins import XSH
ctx = XSH.ctx
mise_init = subprocess.run([Path('~/bin/mise').expanduser(),'activate','xonsh'],capture_output=True,encoding="UTF-8").stdout
XSH.builtins.execx(mise_init,'exec',ctx,filename='mise')
Or continue to use rc.xsh
/.xonshrc
:
echo 'execx($(~/bin/mise activate xonsh))' >> ~/.config/xonsh/rc.xsh # or ~/.xonshrc
Given that mise
replaces both shell env $PATH
and OS environ PATH
, watch out that your configs don't have these two set differently (might throw os.environ['PATH'] = xonsh.built_ins.XSH.env.get_detyped('PATH')
at the end of a config to make sure they match)
Elvish
Add following to your rc.elv
:
var mise: = (eval &ns=[&] &on-end=$put~ (mise activate elvish | slurp))
mise:activate
Optionally alias mise
to mise:mise
for seamless integration of mise {activate,deactivate,shell}
:
fn mise {|@args| mise:mise $@args }
Something else?
Adding a new shell is not hard at all since very little shell code is in this project. See here for how the others are implemented. If your shell isn't currently supported I'd be happy to help you get yours integrated.
Autocompletion
The mise completion
command can generate autocompletion scripts for your shell. This requires usage
to be installed. If you don't have it, install it with:
mise use -g usage
Then, run the following commands to install the completion script for your shell:
# This requires bash-completion to be installed
mkdir -p /etc/bash_completion.d/
mise completion bash > /etc/bash_completion.d/mise
# If you use oh-my-zsh, there is a `mise` plugin. Update your .zshrc file with:
# plugins=(... mise)
# Otherwise, look where zsh search for completions with
echo $fpath | tr ' ' '\n'
# if you installed zsh with `apt-get` for example, this will work:
mkdir -p /usr/local/share/zsh/site-functions
mise completion zsh > /usr/local/share/zsh/site-functions/_mise
mise completion fish > ~/.config/fish/completions/mise.fish
Then source your shell's rc file or restart your shell.
Uninstalling
Use mise implode
to uninstall mise. This will remove the mise binary and all of its data. Use mise implode --help
for more information.
Alternatively, manually remove the following directories to fully clean up:
~/.local/share/mise
(can also beMISE_DATA_DIR
orXDG_DATA_HOME/mise
)~/.local/state/mise
(can also beMISE_STATE_DIR
orXDG_STATE_HOME/mise
)~/.config/mise
(can also beMISE_CONFIG_DIR
orXDG_CONFIG_HOME/mise
)- on Linux:
~/.cache/mise
(can also beMISE_CACHE_DIR
orXDG_CACHE_HOME/mise
) - on macOS:
~/Library/Caches/mise
(can also beMISE_CACHE_DIR
)