salt-minion - Man Page
Name
salt-minion — salt-minion Documentation
The Salt minion daemon, receives commands from a remote Salt master.
Synopsis
salt-minion [ options ]
Description
The Salt minion receives commands from the central Salt master and replies with the results of said commands.
Options
- --version
Print the version of Salt that is running.
- --versions-report
Show program's dependencies and version number, and then exit
- -h, --help
Show the help message and exit
- -c CONFIG_DIR, --config-dir=CONFIG_dir
The location of the Salt configuration directory. This directory contains the configuration files for Salt master and minions. The default location on most systems is /etc/salt.
- -u USER, --user=USER
Specify user to run salt-minion
- -d, --daemon
Run salt-minion as a daemon
- --pid-file PIDFILE
Specify the location of the pidfile. Default: /var/run/salt-minion.pid
- --disable-keepalive
Disable the automatic restart mechanism for salt-minion. By default, the daemon runs in a subprocess with automatic restart capabilities if it exits with a keepalive signal. This option disables that behavior and runs the daemon directly without the keepalive wrapper. Useful when an external process manager like systemd handles restarts, or in containerized environments where the container runtime manages the process lifecycle
Logging Options
Logging options which override any settings defined on the configuration files.
- -l LOG_LEVEL, --log-level=LOG_LEVEL
Console logging log level. One of all, garbage, trace, debug, info, warning, error, quiet. Default: warning.
- --log-file=LOG_FILE
Log file path. Default: /var/log/salt/minion.
- --log-file-level=LOG_LEVEL_LOGFILE
Logfile logging log level. One of all, garbage, trace, debug, info, warning, error, quiet. Default: warning.
See Also
salt(1) salt(7) salt-master(1)
Author
Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file
Copyright
2026
Referenced By
salt(1), salt-call(1), salt-cloud(1), salt-cp(1), salt-key(1), salt-master(1), salt-proxy(1), salt-run(1), salt-ssh(1), salt-syndic(1), spm(1).