Skip to content

Install mise

Use this when setting up a machine to manage development runtimes like Ruby and Node with mise.

On macOS, install mise with Homebrew.

Terminal window
brew install mise

On Ubuntu 26.04 or newer, install mise with apt using the official PPA.

Terminal window
sudo add-apt-repository -y ppa:jdxcode/mise
sudo apt update -y
sudo apt install -y mise

On older Ubuntu versions or Debian, add the mise apt repository first, then install mise.

Terminal window
sudo apt update -y
sudo apt install -y curl
sudo install -dm 755 /etc/apt/keyrings
curl -fSs https://mise.en.dev/gpg-key.pub | sudo tee /etc/apt/keyrings/mise-archive-keyring.asc > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.asc] https://mise.en.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/mise.list
sudo apt update -y
sudo apt install -y mise

Use the standalone installer when Homebrew or apt is not the right fit.

Terminal window
curl https://mise.run | sh

Add mise activation to the shell config file.

For Zsh:

Terminal window
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
source ~/.zshrc

For Bash:

Terminal window
echo 'eval "$(mise activate bash)"' >> ~/.bashrc
source ~/.bashrc

Check that the mise command is available.

Terminal window
mise --version

Check which tools mise is managing.

Terminal window
mise current

Install and activate the latest Ruby version for the current project.

Terminal window
mise use ruby@latest
ruby -v

Use --global when setting the default Ruby version for the whole machine.

Terminal window
mise use --global ruby@latest
ruby -v

Install and activate the latest Node.js version for the current project.

Terminal window
mise use node@latest
node -v
npm -v

Use --global when setting the default Node.js version for the whole machine.

Terminal window
mise use --global node@latest
node -v
npm -v

Refresh mise shims after installing command-line tools through a language package manager, such as Ruby gems or global npm packages.

Terminal window
mise reshim

For example, after installing Rails:

Terminal window
gem install rails
mise reshim
rails -v