<!-- @generated by usage-cli from usage spec -->
# `mise bootstrap remote`

- **Usage**: `mise bootstrap remote [FLAGS] [TARGET]…`
- **Effect**: destructive — may delete or irreversibly overwrite
- **Source code**: [`src/cli/bootstrap.rs`](https://github.com/jdx/mise/blob/main/src/cli/bootstrap.rs)

Bootstrap one or more machines over OpenSSH

## Arguments

### `[TARGET]…`

Inventory host names from `[bootstrap.remote.hosts]`

## Flags

### `--all`

Select every configured inventory host

### `--bootstrap-command <COMMAND>`

Explicit remote shell command that installs mise and places it on PATH

### `--connect-timeout <CONNECT_TIMEOUT>`

SSH connection timeout in seconds

**Default:** `10`

### `--exclude… <PATTERN>`

Additional archive pattern to exclude; repeat for multiple patterns

### `--fail-fast`

Stop after the first failed target

### `--force-dotfiles`

Allow remote dotfile conflicts to be replaced

### `--host… <[USER@]HOST>`

Ad-hoc SSH destination (`[user@]host`); repeat for multiple hosts

### `-i --identity-file <IDENTITY_FILE>`

SSH identity file override

### `-n --dry-run`

Print the remote bootstrap changes without applying them

### `--keep-staging`

Keep the remote staging directory for debugging

### `--mise-bin <MISE_BIN>`

Local mise binary to upload (escape hatch for custom architectures)

### `--only… <ONLY>`

Run only one or more remote bootstrap parts

**Choices:**

- `plugins`
- `packages`
- `accounts`
- `files`
- `services`
- `firewall`
- `compose`
- `repos`
- `dotfiles`
- `mise-shell-activate`
- `shell`
- `macos-defaults`
- `defaults`
- `macos-launchd-agents`
- `launchd`
- `linux-systemd-units`
- `systemd`
- `user`
- `tools`
- `task`
- `final-hook`

### `--port <PORT>`

SSH port override

### `--prompt-secrets`

Prompt securely for missing secret inputs on the remote host

### `--remote-mise <COMMAND>`

Existing mise executable name or path; relative paths use the staged project

### `--skip… <SKIP>`

Skip one or more remote bootstrap parts

**Choices:**

- `plugins`
- `packages`
- `accounts`
- `files`
- `services`
- `firewall`
- `compose`
- `repos`
- `dotfiles`
- `mise-shell-activate`
- `shell`
- `macos-defaults`
- `defaults`
- `macos-launchd-agents`
- `launchd`
- `linux-systemd-units`
- `systemd`
- `user`
- `tools`
- `task`
- `final-hook`

### `--source <SOURCE>`

Local directory archived and sent to each target

### `--ssh-option… <OPTION>`

OpenSSH `-o` option; repeat for multiple options

### `--tag… <TAG>`

Select configured hosts with this tag; repeat to match any tag

### `--update`

Refresh package manager metadata and update configured repos remotely

### `-y --yes`

Skip remote confirmation prompts
