Skip to content

mise bootstrap remote

  • Usage: mise bootstrap remote [FLAGS] [TARGET]…
  • Effect: destructive — may delete or irreversibly overwrite
  • Source code: 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

MIT LicenseCopyright © 2026jdx.dev