SaltStack 2016.3 Package Repo

Download and install the 2016.3 release of SaltStack.


These instructions are for an older unsupported release of SaltStack. You might want to view instructions for the latest release instead.

This page contains instructions to download and install the 2016.3 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 branch release: 2016.3.8 (October 9, 2017)

ARCHIVE.REPO.SALTSTACK.COM

SEP 22 was accepted which means that all unsupported and CVE affected releases have been moved to https://archive.repo.saltstack.com. If you get 404 errors from your package manager, the release you were using probably moved there. Please consider upgrading to a supported version of Salt. Click here for more information.




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 8 (jessie)

Debian 7 (wheezy)

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2016.3.0

Before you upgrade, you must run the following commands to remove previous packages:

sudo apt-get remove python-pycrypto
sudo apt-get remove python-apache-libcloud

Note that python-pycrypto will likely remove python-apache-libcloud, so the second command might not be necessary. These have been replaced by python-crypto and python-libcloud with ~bpo70+1 moniker.

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/8/amd64/2016.3/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - http://repo.saltstack.com/apt/debian/7/amd64/2016.3/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/8/amd64/2016.3 jessie main
    deb http://repo.saltstack.com/apt/debian/7/amd64/2016.3 wheezy 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

Post-installation configuration


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

Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2016.3.0

Before you upgrade, you must run the following commands to remove previous packages:

sudo apt-get remove python-pycrypto
sudo apt-get remove python-apache-libcloud

Note that python-pycrypto will likely remove python-apache-libcloud, so the second command might not be necessary. These have been replaced by python-crypto and python-libcloud with ~bpo70+1 moniker.

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/8/amd64/archive/2016.3.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - http://repo.saltstack.com/apt/debian/7/amd64/archive/2016.3.8/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/8/amd64/archive/2016.3.8 jessie main
    deb http://repo.saltstack.com/apt/debian/7/amd64/archive/2016.3.8 wheezy 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

Post-installation configuration


Redhat / CentOS 7

Redhat / CentOS 6

Redhat / CentOS 5

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

Final 2016.3 Release of Redhat 5 Packages

Production Phase 3 Support for Redhat 5 will end on March 31 2017. As a result, 2016.3.6 will be the last Salt release on this branch for which Redhat 5 packages are created

  1. Run the following commands to install the SaltStack repository and key:
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2016.3-2.el7.noarch.rpm 
    sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2016.3-2.el6.noarch.rpm
    wget https://repo.saltstack.com/yum/redhat/salt-repo-2016.3-1.el5.noarch.rpm
    sudo rpm -ivh salt-repo-2016.3-1.el5.noarch.rpm
    rm -f salt-repo-2016.3-1.el5.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

Post-installation configuration


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

Final 2016.3 Release of Redhat 5 Packages

Production Phase 3 Support for Redhat 5 will end on March 31 2017. As a result, 2016.3.6 will be the last Salt release on this branch for which Redhat 5 packages are created

  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/2016.3.8/SALTSTACK-GPG-KEY.pub
    sudo rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/archive/2016.3.8/SALTSTACK-GPG-KEY.pub
    wget https://repo.saltstack.com/yum/redhat/5/x86_64/archive/2016.3.8/SALTSTACK-EL5-GPG-KEY.pub
    sudo rpm --import SALTSTACK-EL5-GPG-KEY.pub
    rm -f SALTSTACK-EL5-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/2016.3.8
    enabled=1
    gpgcheck=1
    gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.3.8/SALTSTACK-GPG-KEY.pub
    [saltstack-repo]
    name=SaltStack repo for RHEL/CentOS $releasever
    baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.3.8
    enabled=1
    gpgcheck=1
    gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.3.8/SALTSTACK-GPG-KEY.pub
    [saltstack-repo]
    name=SaltStack repo for RHEL/CentOS $releasever
    baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.3.8
    enabled=1
    gpgcheck=1
    gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.3.8/SALTSTACK-EL5-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

Post-installation configuration


Ubuntu 16 (xenial)

Ubuntu 14 (trusty)

Ubuntu 12 (precise)

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

Final 2016.3 Release of Ubuntu 12 Packages

End of Life Support for Ubuntu 12 will end in April 2017. As a result, 2016.3.6 will be the last Salt release on this branch for which Ubuntu 12 packages are created

  1. Run the following command to import the SaltStack repository key:
    wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/2016.3/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/2016.3/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/2016.3/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/16.04/amd64/2016.3 xenial main
    deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/2016.3 trusty main
    deb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/2016.3 precise 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

Post-installation configuration


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

Final 2016.3 Release of Ubuntu 12 Packages

End of Life Support for Ubuntu 12 will end in April 2017. As a result, 2016.3.6 will be the last Salt release on this branch for which Ubuntu 12 packages are created

  1. Run the following command to import the SaltStack repository key:
    wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2016.3.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2016.3.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2016.3.8/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/16.04/amd64/archive/2016.3.8 xenial main
    deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2016.3.8 trusty main
    deb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2016.3.8 precise 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

Post-installation configuration


SLES 12 SP1

SLES 12

SLES 11

openSUSE 13

openSUSE Leap 42.1

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

Prerequisites: Ensure that libgit2-devel and python-devel are installed or Salt will not work after installation:

sudo zypper install libgit2-devel python-devel

Prerequisites: If using salt-cloud, also install python-apache-libcloud and python-lxml:

sudo zypper install python-apache-libcloud python-lxml
  1. Run the following command to add the SaltStack repository:
    sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12/systemsmanagement:saltstack.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12/systemsmanagement:saltstack.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_11_SP4/systemsmanagement:saltstack.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_13.2/systemsmanagement:saltstack.repo
    sudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Leap_42.1/systemsmanagement:saltstack.repo
  2. Refresh the package list:

    sudo zypper refresh
  1. Install the salt-minion, salt-master, or other Salt components:
    • sudo zypper install salt-master=2015.8.10-76.5
    • sudo zypper install salt-minion=2015.8.10-76.5
    • sudo zypper install salt-ssh=2015.8.10-76.5
    • sudo zypper install salt-syndic=2015.8.10-76.5
    • sudo zypper install salt-cloud=2015.8.10-76.5
    • sudo zypper install salt-api=2015.8.10-76.5
    • sudo zypper install salt-proxy=2015.8.10-76.5
  1. Install the salt-minion, salt-master, or other Salt components:
    • sudo zypper install salt-master=2015.8.10-76.1
    • sudo zypper install salt-minion=2015.8.10-76.1
    • sudo zypper install salt-ssh=2015.8.10-76.1
    • sudo zypper install salt-syndic=2015.8.10-76.1
    • sudo zypper install salt-cloud=2015.8.10-76.1
    • sudo zypper install salt-api=2015.8.10-76.1
    • sudo zypper install salt-proxy=2015.8.10-76.1

Post-installation configuration


Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

  1. Run the following command to import the SaltStack repository key:
    wget -O - https://repo.saltstack.com/apt/suse/14.04/amd64/2016.3/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/2016.3/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/suse/14.04/amd64/2016.3 trusty main
    deb http://repo.saltstack.com/apt/suse/12.04/amd64/2016.3 precise 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
    • sudo apt-get install salt-api

Post-installation configuration


Installs the 2016.3.8 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/suse/14.04/amd64/archive/2016.3.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/archive/2016.3.8/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/suse/14.04/amd64/archive/2016.3.8 trusty main
    deb http://repo.saltstack.com/apt/suse/12.04/amd64/archive/2016.3.8 precise 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

Post-installation configuration


Fedora 25

Fedora 24

Installs a specific release.

The 2016.3 branch for Fedora will no longer receive updates since Fedora only receives the latest updates for packages. The latest salt branch will continue to receive updates for Fedora going forward.

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

Post-installation configuration


Windows

Installation executables:

AMD64: Salt-Minion-2016.3.8-AMD64-Setup.exe | MD5

x86: Salt-Minion-2016.3.8-x86-Setup.exe | MD5

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-2016.3.8-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname

Post-installation configuration


macOS

salt-2016.3.8-x86_64.pkg | MD5

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

Installs the latest release from the 2016.3 branch. Updating installs the latest minor release from the 2016.3 branch.

  1. Run the following commands to install the SaltStack repository and key:
    sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-2016.3-1.ami.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

Post-installation configuration


Installs the 2016.3.8 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/6/x86_64/archive/2016.3.8/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
    baseurl=https://repo.saltstack.com/yum/redhat/6/$basearch/archive/2016.3.8
    enabled=1
    gpgcheck=1
    gpgkey=https://repo.saltstack.com/yum/redhat/6/$basearch/archive/2016.3.8/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

Post-installation configuration


Raspbian was tested on Pi-2 and Pi-3. Raspbian is based on Debian 8 (jessie).

Raspbian (jessie)

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/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/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/8/armhf/2016.3/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/8/armhf/2016.3 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/8/armhf/archive/2016.3.8/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/8/armhf/archive/2016.3.8 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.