<!-- @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`](https://github.com/jdx/mise/blob/main/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 node@20.0.0  # 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
```
