SaltStack Package Repo

Download and install the latest release of SaltStack.


Get Started

Our Fundamentals Guide is a great place to learn the basics.

SaltStack Platform Support

Visit the SaltStack Platform Support site to learn how long a particular operating system and SaltStack version will receive official packages, testing, and technical support.

This page contains instructions to download and install the latest release of SaltStack.

Bootstrap works across many platforms and is the easiest way to get started. If you cannot use Bootstrap or if you prefer packages, click the tab for your platform.

Latest release: 2019.2.0 (February 25, 2019)

PYTHON 2.7 DEPRECATION

In light of Python 2.7 reaching its End of Life (EOL) on Jan 1st 2020, Python 2 will be deprecated from SaltStack no earlier then the Sodium release, that is either the Sodium release or a later release. This decision is pending further community discussion.




Bootstrap - Multi-Platform

Salt Bootstrap is a shell script that detects the target platform and selects the best installation method. (Supported Platforms)

On the Salt master

Run these commands on the system that you want to use as the central management point.

curl -L https://bootstrap.saltstack.com -o install_salt.sh
sudo sh install_salt.sh -P -M

Your Salt master can manage itself, so a Salt minion is installed along with the Salt master. If you do not want to install the minion, also pass the -N option.

On each Salt minion

Run these commands on each system that you want to manage using Salt.

curl -L https://bootstrap.saltstack.com -o install_salt.sh
sudo sh install_salt.sh -P

Post-installation configuration

Debian 9 (stretch) PY2

Debian 9 (stretch) PY3

Debian 8 (jessie)

Installs the latest release. Updating installs the latest release even if it is a new major version.

Read Before Upgrading Debian 8 (Jessie) from Salt Versions Earlier than 2015.8.4

Salt systemd service files are missing the following statement in these versions:

[Service]
KillMode=process

This statement must be added to successfully upgrade on these earlier versions of Salt.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/amd64/latest stretch main
    deb http://repo.saltstack.com/py3/debian/9/amd64/latest stretch main
    deb http://repo.saltstack.com/apt/debian/8/amd64/latest jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion

Post-installation configuration

Installs the latest release. Updating installs the latest minor release but not a new major version.

Read Before Upgrading Debian 8 (Jessie) from Salt Versions Earlier than 2015.8.4

Salt systemd service files are missing the following statement in these versions:

[Service]
KillMode=process

This statement must be added to successfully upgrade on these earlier versions of Salt.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/amd64/2019.2 stretch main
    deb http://repo.saltstack.com/py3/debian/9/amd64/2019.2 stretch main
    deb http://repo.saltstack.com/apt/debian/8/amd64/2019.2 jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion

Post-installation configuration

Installs a specific release. Updating doesn’t change the release that is installed.

Read Before Upgrading Debian 8 (Jessie) from Salt Versions Earlier than 2015.8.4

Salt systemd service files are missing the following statement in these versions:

[Service]
KillMode=process

This statement must be added to successfully upgrade on these earlier versions of Salt.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/amd64/archive/2019.2.0 stretch main
    deb http://repo.saltstack.com/py3/debian/9/amd64/archive/2019.2.0 stretch main
    deb http://repo.saltstack.com/apt/debian/8/amd64/archive/2019.2.0 jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion

Post-installation configuration

Redhat / CentOS 7 PY2

Redhat / CentOS 7 PY3

Redhat / CentOS 6 PY2

WARNING: Redhat Python 3 support requires that EPEL be previously installed. The Python 3 packages now comes with Python 3.6

Installs the latest release. Updating installs the latest release even if it is a new major version.

  1. Run the following commands to install the SaltStack repository and key: 
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-latest.el7.noarch.rpm 
    sudo yum install https://repo.saltstack.com/py3/redhat/salt-py3-repo-latest.el7.noarch.rpm
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-latest.el6.noarch.rpm

  2. Run sudo yum clean expire-cache

  3. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  4. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

WARNING: Redhat Python 3 support requires that EPEL be previously installed. The Python 3 packages now comes with Python 3.6

Installs the latest release. Updating installs the latest minor release but not a new major version.

  1. Run the following commands to install the SaltStack repository and key: 
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2019.2.el7.noarch.rpm 
    sudo yum install https://repo.saltstack.com/py3/redhat/salt-py3-repo-2019.2.el7.noarch.rpm 
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2019.2.el6.noarch.rpm

  2. Run sudo yum clean expire-cache

  3. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  4. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

WARNING: Redhat Python 3 support requires that EPEL be previously installed. The Python 3 packages now comes with Python 3.6

Installs a specific release. Updating doesn’t change the release that is installed.

  1. Run the following commands to install the SaltStack repository and key:

    sudo rpm --import https://repo.saltstack.com/yum/redhat/7/x86_64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    sudo rpm --import https://repo.saltstack.com/py3/redhat/7/x86_64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    sudo rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub

  2. Save the following file to /etc/yum.repos.d/saltstack.repo:

    [saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2019.2.0
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    [saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever PY3
baseurl=https://repo.saltstack.com/py3/redhat/$releasever/$basearch/archive/2019.2.0
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/py3/redhat/$releasever/$basearch/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    [saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2019.2.0
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2019.2.0/SALTSTACK-GPG-KEY.pub

  3. Run sudo yum clean expire-cache

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

Ubuntu 18 (bionic) PY2

Ubuntu 18 (bionic) PY3

Ubuntu 16 (xenial) PY2

Ubuntu 16 (xenial) PY3

Ubuntu 14 (trusty) PY2

Installs the latest release. Updating installs the latest release even if it is a new major version.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/ubuntu/18.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/18.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/16.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/ubuntu/18.04/amd64/latest bionic main
    deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest xenial main
    deb http://repo.saltstack.com/py3/ubuntu/18.04/amd64/latest bionic main
    deb http://repo.saltstack.com/py3/ubuntu/16.04/amd64/latest xenial main
    deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/latest trusty main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

Installs the latest release. Updating installs the latest minor release but not a new major version.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/ubuntu/18.04/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/18.04/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/16.04/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/ubuntu/18.04/amd64/2019.2 bionic main
    deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/2019.2 xenial main
    deb http://repo.saltstack.com/py3/ubuntu/18.04/amd64/2019.2 bionic main
    deb http://repo.saltstack.com/py3/ubuntu/16.04/amd64/2019.2 xenial main
    deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/2019.2 trusty main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

Installs a specific release. Updating doesn’t change the release that is installed.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/ubuntu/18.04/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/18.04/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/ubuntu/16.04/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/ubuntu/18.04/amd64/archive/2019.2.0 bionic main
    deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2019.2.0 xenial main
    deb http://repo.saltstack.com/py3/ubuntu/18.04/amd64/archive/2019.2.0 bionic main
    deb http://repo.saltstack.com/py3/ubuntu/16.04/amd64/archive/2019.2.0 xenial main
    deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2019.2.0 trusty main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo systemctl restart salt-minion
    sudo service salt-minion restart

Post-installation configuration

SLES 12 SP2

SLES 11 SP4

openSUSE Leap 15

openSUSE Leap 42.2

openSUSE Leap 42.3

openSUSE Tumbleweed

Installs the latest release. Updating installs the latest release even if it is a new major version.

  1. Run the following command to add the SaltStack repository: 
    sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12_SP2/systemsmanagement:saltstack:products.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_11_SP4/systemsmanagement:saltstack:products.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Leap_15.0/systemsmanagement:saltstack:products.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Leap_42.2/systemsmanagement:saltstack:products.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Leap_42.3/systemsmanagement:saltstack:products.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Tumbleweed/systemsmanagement:saltstack:products.repo

  2. Refresh the package list:

    sudo zypper refresh
  3. Install the salt-minion, salt-master, or other Salt components:
    • sudo zypper install salt-master
    • sudo zypper install salt-minion
    • sudo zypper install salt-ssh
    • sudo zypper install salt-syndic
    • sudo zypper install salt-cloud
    • sudo zypper install salt-api
    • sudo zypper install salt-proxy
  4. (Upgrade only) Restart all upgraded services, for example: 
    sudo systemctl restart salt-minion

    or

    sudo service salt-minion restart

Post-installation configuration

Fedora 29

Fedora 28

Installs the latest release. Updating installs the latest release even if it is a new major version.

Currently Salt 2018.3.3 is available for Fedora stable, however Salt 2019.2.0 is available from the testing repo and is expected to migrate to stable soon.

  1. Packages are available in the standard Fedora repositories. Install the salt-minion, salt-master, or other Salt components:
    • sudo dnf install salt-master
    • sudo dnf install salt-minion
    • sudo dnf install salt-ssh
    • sudo dnf install salt-syndic
    • sudo dnf install salt-cloud
    • sudo dnf install salt-api

Post-installation configuration

Installs the latest release. Updating installs the latest minor release but not a new major version.

Currently Salt 2018.3.3 is available for Fedora stable, however Salt 2019.2.0 is available from the testing repo and is expected to migrate to stable soon.

  1. Packages are available in the standard Fedora repositories. Install the salt-minion, salt-master, or other Salt components:
    • sudo dnf install salt-master
    • sudo dnf install salt-minion
    • sudo dnf install salt-ssh
    • sudo dnf install salt-syndic
    • sudo dnf install salt-cloud
    • sudo dnf install salt-api

Post-installation configuration

Installs a specific release.

  1. Packages are available in the standard Fedora repositories. Install the salt-minion, salt-master, or other Salt components:
    • sudo dnf install salt-master-2018.3.3
    • sudo dnf install salt-minion-2018.3.3
    • sudo dnf install salt-ssh-2018.3.3
    • sudo dnf install salt-syndic-2018.3.3
    • sudo dnf install salt-cloud-2018.3.3
    • sudo dnf install salt-api-2018.3.3

Post-installation configuration

Windows PY2

Windows PY3

Installation executables:

AMD64: Salt-Minion-2019.2.0-Py2-AMD64-Setup.exe | MD5 | SHA256

x86: Salt-Minion-2019.2.0-Py2-x86-Setup.exe | MD5 | SHA256

AMD64: Salt-Minion-2019.2.0-Py3-AMD64-Setup.exe | MD5 | SHA256

x86: Salt-Minion-2019.2.0-Py3-x86-Setup.exe | MD5 | SHA256

Silent Installation Options

The installer can be run silently by providing the /S option at the command line. The options /master and /minion-name allow for configuring the master hostname and minion name, respectively. Here’s an example of running a silent installation from the command line:

Salt-Minion-2019.2.0-Py2-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname
Salt-Minion-2019.2.0-Py3-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname

Post-installation configuration

macOS PY2

macOS PY3

Installation executables:

salt-2019.2.0-py2-x86_64.pkg | MD5 | SHA256

salt-2019.2.0-py3-x86_64.pkg | MD5 | SHA256

OS X Gatekeeper settings might prevent installation of the Salt package. If a warning appears during installation, open System Preferences > Security & Privacy > click Open Anyway

Initial Configuration

After the installation completes, run the following to configure the Salt minion ID, the Salt master location, and to start the required services.

sudo salt-config -i yourminionname -m yoursaltmaster

Start and Stop the Minion Service

On OS X, the Salt minion configuration file is in the standard /etc/salt/minion location. To stop the Salt minion, run the following:

sudo launchctl stop com.saltstack.salt.minion

To start the Salt minion, run the following:

sudo launchctl start com.saltstack.salt.minion

Post-installation configuration

Amazon Linux 2

Amazon Linux

Installs the latest release. Updating installs the latest release even if it is a new major version.

  1. Run the following commands to install the SaltStack repository and key: 
    sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn2-repo-latest.amzn2.noarch.rpm
    sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-latest.amzn1.noarch.rpm

  2. Run sudo yum clean expire-cache

  3. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  4. (Upgrade only) Restart all upgraded services, for example: 
    sudo service salt-minion restart

Post-installation configuration

Installs the latest release. Updating installs the latest minor release but not a new major version.

  1. Run the following commands to install the SaltStack repository and key: 
    sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn2-repo-2019.2.amzn2.noarch.rpm
    sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-2019.2.amzn1.noarch.rpm

  2. Run sudo yum clean expire-cache

  3. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  4. (Upgrade only) Restart all upgraded services, for example: 
    sudo service salt-minion restart

Post-installation configuration

Installs a specific release. Updating doesn’t change the release that is installed.

  1. Run the following commands to install the SaltStack repository and key:

    sudo rpm --import https://repo.saltstack.com/yum/amazon/2/x86_64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    sudo rpm --import https://repo.saltstack.com/yum/amazon/latest/x86_64/archive/2019.2.0/SALTSTACK-GPG-KEY.pub

  2. Save the following file to /etc/yum.repos.d/saltstack-amzn.repo:

    [saltstack-amzn-repo]
name=SaltStack repo for Amazon Linux 2
baseurl=https://repo.saltstack.com/yum/amazon/2/$basearch/archive/2019.2.0
failovermethod=priority
priority=10
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/amazon/2/$basearch/archive/2019.2.0/SALTSTACK-GPG-KEY.pub
    [saltstack-amzn-repo]
name=SaltStack repo for Amazon Linux
baseurl=https://repo.saltstack.com/yum/amazon/latest/$basearch/archive/2019.2.0
failovermethod=priority
priority=10
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/amazon/latest/$basearch/archive/2019.2.0/SALTSTACK-GPG-KEY.pub

  3. Run sudo yum clean expire-cache

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo yum install salt-master
    • sudo yum install salt-minion
    • sudo yum install salt-ssh
    • sudo yum install salt-syndic
    • sudo yum install salt-cloud
    • sudo yum install salt-api
  5. (Upgrade only) Restart all upgraded services, for example: 
    sudo service salt-minion restart

Post-installation configuration

Raspbian 9 (stretch) PY2

Raspbian 9 (stretch) PY3

Raspbian 8 (jessie) PY2

Installs the latest release. Updating installs the latest release even if it is a new major version.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/armhf/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/armhf/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/armhf/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/armhf/latest stretch main
    deb http://repo.saltstack.com/py3/debian/9/armhf/latest stretch main
    deb http://repo.saltstack.com/apt/debian/8/armhf/latest jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api

  5. (Upgrade only) Restart all upgraded services, for example:

    sudo systemctl restart salt-minion

Post-installation configuration

Installs the latest release. Updating installs the latest minor release but not a new major version.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/armhf/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/armhf/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/armhf/2019.2/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/armhf/2019.2 stretch main
    deb http://repo.saltstack.com/py3/debian/9/armhf/2019.2 stretch main
    deb http://repo.saltstack.com/apt/debian/8/armhf/2019.2 jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api

  5. (Upgrade only) Restart all upgraded services, for example:

    sudo systemctl restart salt-minion

Post-installation configuration

Installs a specific release. Updating doesn’t change the release that is installed.

  1. Run the following command to import the SaltStack repository key: 
    wget -O - https://repo.saltstack.com/apt/debian/9/armhf/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/py3/debian/9/armhf/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/debian/8/armhf/archive/2019.2.0/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
  2. Save the following file to /etc/apt/sources.list.d/saltstack.list: 
    deb http://repo.saltstack.com/apt/debian/9/armhf/archive/2019.2.0 stretch main
    deb http://repo.saltstack.com/py3/debian/9/armhf/archive/2019.2.0 stretch main
    deb http://repo.saltstack.com/apt/debian/8/armhf/archive/2019.2.0 jessie main

  3. Run sudo apt-get update

  4. Install the salt-minion, salt-master, or other Salt components:
    • sudo apt-get install salt-master
    • sudo apt-get install salt-minion
    • sudo apt-get install salt-ssh
    • sudo apt-get install salt-syndic
    • sudo apt-get install salt-cloud
    • sudo apt-get install salt-api

  5. (Upgrade only) Restart all upgraded services, for example:

    sudo systemctl restart salt-minion

Post-installation configuration

Create a Local Mirror of the SaltStack Package Repo

The SaltStack package repo supports mirroring using rsync.

Rsync used to be available from both rsync.repo.saltstack.com and repo.saltstack.com. Going forward, only rsync.repo.saltstack.com will be available. Please check your scripts.

rsync rsync://rsync.repo.saltstack.com

For example:

rsync -vaH --numeric-ids --delete --delete-after --delay-updates rsync://rsync.repo.saltstack.com/saltstack_pkgrepo_full ./fullrepo

Other Platforms

For installation on other platforms and alternative installation methods, see the SaltStack Installation Instructions.

© 2019 Saltstack. All Rights Reserved, SaltStack Inc. | Privacy Policy