Install Salt#

Welcome to the Salt install guide! This guide provides instructions for installing Salt on Supported operating systems. It also explains how to configure Salt, start Salt services, and verify your installation.

Danger

Beginning with the 3005 release of Salt, the Salt Project is changing its packaging system to onedir. See What is onedir? for more information.

The Salt Project will phase out the old package builds for supported operating systems by 3006. Update your Salt infrastructure to the new onedir packages as soon as possible. See Upgrade to onedir for instructions.

Standard installation overview#

Using the standard installation method is recommended for most organizations, especially if you are just starting out with Salt. The standard installation will make using Salt easier and provides functionality that isn’t available in masterless/agentless Salt configurations.

  Process For more information
1 Before you start the installation, check the system requirements to ensure your platform is supported in the latest version of Salt and open the required network ports.
2

Install the salt-master service on the node that will manage your other nodes, meaning it will send commands to other nodes. Then, install the salt-minion service on the nodes that will be managed by the Salt master.

For Linux-based operating systems, the recommended installation method is to use the bootstrap script or you can manually install Salt using the instructions for each operating system.

For Windows or macOS operating systems, you need to download and run the installer file for that system.

For Linux-based systems:
For macOS or Windows:
For all operating systems:
3 Configure the Salt minions to add the DNS/hostname or IP address of the Salt master they will connect to. You can add additional configurations to the master and minions as needed.
4 Start the service on the master, then the minions. Start the master and minion services
5 Accept the minion keys after the minion connects. Accept the minion keys
6 Verify that the installation was successful by sending a test ping. Verify a Salt install

Alternative installations and configurations#

In general, you should only use alternative installation and configuration options if you are an intermediate or advanced Salt user.

Although the standard Salt configuration model is the master/minion (master/client) model, minions do not necessarily have to have a master to be managed. Salt also gives additional options for managing minions:

Type Description For more information
Masterless Running a masterless salt-minion lets you use Salt’s configuration management for a single machine without calling out to a Salt master on another machine. Salt masterless quickstart
Salt cloud Provisions and manages systems on cloud hosts or hypervisors. It uses the Saltify drive to install Salt on existing machines (virtual or bare metal).
Proxy minions Send and receive commands from minions that, for whatever reason, can’t run the standard salt-minion service. Proxy minions
Agentless Use SSH to run Salt commands on a minion without installing an agent. Salt SSH
Install Salt for development If you plan to contribute to the Salt codebase, use this installation method. Installing Salt for development