Skip to content

mise system install

Install missing system packages from [system.packages], apply files from [system.files] and edits from [system.edits], write macOS defaults from [system.defaults], and set Unix login shell from [system].login_shell

Checks which configured packages are missing and installs them with the system package manager. This may elevate with sudo when not running as root (see the system_packages.sudo setting). Afterwards, [system.files] and [system.edits] entries that aren't in their desired state are applied, on macOS any [system.defaults] entries that are unset or differ are written, and on Unix [system].login_shell is added to /etc/shells if needed before chsh -s applies it.

Packages can also be given explicitly in manager:package form (e.g. apt:curl, brew:jq); they are installed whether or not they appear in the config. Explicit packages and --manager scope the run to packages only.

Arguments

[PACKAGE]…

Packages in manager:package form; defaults to everything configured in [system.packages]

Flags

-f --force

Overwrite existing files that conflict with [system.files] entries

-m --manager <MANAGER>

Only install packages for this manager, e.g. apt or brew

Choices:

  • apt
  • brew
  • dnf
  • pacman

-n --dry-run

Print the commands that would run without running them

-y --yes

Skip the confirmation prompt

--update

Refresh package manager metadata first (apt: apt-get update)

Examples:

mise system install
mise system install apt:curl brew:jq
mise system install --dry-run
mise system install --manager apt --yes
MIT LicenseCopyright © 2026en.dev