Skip to content

mise system use

Add system packages to [system.packages] and install them

Like mise use for tools: writes "manager:package" = "version" entries to mise.toml (the local config by default, the global one with -g) and then installs whatever is missing.

Versions are pinned with @: mise system use apt:curl@8.5.0-2. Without @ (or with @latest) no pin is written. brew formulae version through their names instead (brew:postgresql@17), so @ is always part of the formula name there.

Arguments

<PACKAGE>…

Packages in manager:package[@version] form

Flags

-e --env <ENV>

Write to the config file for this environment (mise.<ENV>.toml)

-g --global

Write to the global config (~/.config/mise/config.toml) instead of the local one

-n --dry-run

Print the commands that would run without writing config or installing

-p --path <PATH>

Write to this config file or directory

-y --yes

Skip the confirmation prompt

Examples:

mise system use apt:curl brew:jq
mise system use -g brew:postgresql@17
mise system use apt:curl@8.5.0-2
MIT LicenseCopyright © 2026en.dev