ContextQMD
Back to Mise

`mise install`

docs/cli/install.md

2026.9.23.6 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 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 the selected project config so the tool is active in that configuration scope. 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 [email protected]  # 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
<!-- generated reference navigation -->