<!-- @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]

### `-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.

### `--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).

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
```
