mise install

• Usage: mise install [FLAGS] [TOOL@VERSION]…
• Aliases: i
• Effect: modifies state
• Source code: src/cli/install.rs

Install a tool version

Installs a tool version under the mise data directory, by default ~/.local/share/mise/installs/<TOOL>/<VERSION>. Installing alone does not add the tool to your config, so a tool that is not already configured will not be on PATH. To install and activate in one command, use mise use, which also writes the version to mise.toml in the current directory so the tool is active inside it. To run a tool once without touching any config, use mise exec <TOOL>@<VERSION> -- <COMMAND>.

Tools are installed in parallel. To disable, set --jobs=1 or MISE_JOBS=1.

Arguments

• [TOOL@VERSION]… — Tool(s) to install e.g.: node@20

Flags

• -f --force — Force reinstall even if already installed With no tools specified, reinstall all configured tools

• -j --jobs <JOBS> — Number of jobs to run in parallel Values below 1 are treated as 1 Defaults to the jobs setting

  Environment Variable: MISE_JOBS

• -n --dry-run — Show what would be installed without actually installing

• -v --verbose — Show installation output

  This argument will print backend output such as download, configuration, and compilation output.

• --dry-run-code — Like --dry-run but exits with code 1 if there are tools to install

  This is useful for scripts to check if tools need to be installed.

• --include-task-tools — Also install tools required by tasks in the current scope

  This prepares task tools without running task commands or dependencies. Combine with --monorepo to include tasks from every configured root.

• --include-lazy — Also install tools configured with lazy = true

  By default, a bare mise install leaves lazy tools for first-command installation.

• --minimum-release-age <MINIMUM_RELEASE_AGE> — Only install versions released before this date or older than this duration

  Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".

• --monorepo — Install tools from every [monorepo].config_roots config root

  Uses the active MISE_ENV and requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config.

  Environment Variable: MISE_MONOREPO

• --raw — Connect backend install command stdin/stdout/stderr directly to the terminal. Implies --jobs=1

• --shared <SHARED> — Install tool(s) to a shared directory

  Installs to the specified directory instead of the default install location. May require elevated permissions depending on the path.

• --system — Install tool(s) to the system-wide shared directory

  Installs to /usr/local/share/mise/installs (or MISE_SYSTEM_DATA_DIR/installs). May require elevated permissions (e.g. sudo).

• -h --help — Print help

Examples:

mise install node@20.0.0  # install a specific node version
mise install node@20      # install the latest node 20.x
mise install node         # install the version specified in mise.toml
mise install              # install everything specified in mise.toml
mise install --include-lazy # also install tools configured for lazy installation
mise install --include-task-tools # also install tools required by tasks