ContextQMD
Back to Mise

`mise install`

docs/cli/install.md

2026.8.123.1 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

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 to ~/.local/share/mise/installs/<TOOL>/<VERSION> Installing alone will not activate the tools so they won't be in PATH. To install and/or activate in one command, use mise use which will create a mise.toml file in the current directory to activate this tool when inside the directory. Alternatively, run mise exec <TOOL>@<VERSION> -- <COMMAND> to execute a tool without creating config files.

Tools will be 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 [default: 4]

    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.

  • --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 [email protected]  # install specific node version
mise install node@20      # install fuzzy node version
mise install node         # install version specified in mise.toml
mise install              # installs everything specified in mise.toml
mise install --include-task-tools # also install tools required by tasks