Download and install the 2015.8 release of SaltStack.
These instructions are for an older supported release of SaltStack. You might want to view instructions for the latest release instead. This release is currently in Extended Life Support. Please see Product Support Lifecycle page for more information
This page contains instructions to download and install the 2015.8 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: 2015.8.13 (January 30, 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.
Salt Bootstrap is a shell script that detects the target platform and selects the best installation method. (Supported Platforms)
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 -MYour 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.
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 -PPost-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
2015.8.10 Final Branch Release of Debian 7 Packages
Regular security support for Debian 7 ended on April 25th 2016. As a result, 2015.8.10 was the last Salt release on this branch for which Debian 7 packages were created.
These instructions show you how to install 2015.8.10 on Debian 7.
Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2015.8.10
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=processThis statement must be added to successfully upgrade on these earlier versions of Salt.
wget -O - https://repo.saltstack.com/apt/debian/8/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - http://repo.saltstack.com/apt/debian/7/amd64/archive/2015.8.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/debian/8/amd64/2015.8 jessie maindeb http://repo.saltstack.com/apt/debian/7/amd64/archive/2015.8.10 wheezy mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apiPost-installation configuration
Installs the 2015.8.13 release. Updating doesn’t change the release that is installed.
Final Release of Debian 7 Packages
Regular security support for Debian 7 ended on April 25th 2016. As a result, 2015.8.10 will be the last Salt release on this branch for which Debian 7 packages are created.
Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2015.8.10
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=processThis statement must be added to successfully upgrade on these earlier versions of Salt.
wget -O - https://repo.saltstack.com/apt/debian/8/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - http://repo.saltstack.com/apt/debian/7/amd64/archive/2015.8.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/debian/8/amd64/archive/2015.8.13 jessie maindeb http://repo.saltstack.com/apt/debian/7/amd64/archive/2015.8.10 wheezy mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apiPost-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2015.8-3.el7.noarch.rpm sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2015.8-3.el6.noarch.rpmwget https://repo.saltstack.com/yum/redhat/salt-repo-2015.8-3.el5.noarch.rpm
sudo rpm -ivh salt-repo-2015.8-3.el5.noarch.rpm
rm -f salt-repo-2015.8-3.el5.noarch.rpmRun sudo yum clean expire-cache
sudo yum install salt-mastersudo yum install salt-minionsudo yum install salt-sshsudo yum install salt-syndicsudo yum install salt-cloudsudo yum install salt-apiPost-installation configuration
Installs the 2015.8.13 release. Updating doesn’t change the release that is installed.
Run the following commands to install the SaltStack repository and key:
sudo rpm --import https://repo.saltstack.com/yum/redhat/7/x86_64/archive/2015.8.13/SALTSTACK-GPG-KEY.pubsudo rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/archive/2015.8.13/SALTSTACK-GPG-KEY.pubwget https://repo.saltstack.com/yum/redhat/5/x86_64/archive/2015.8.13/SALTSTACK-EL5-GPG-KEY.pub
sudo rpm --import SALTSTACK-EL5-GPG-KEY.pub
rm -f SALTSTACK-EL5-GPG-KEY.pubSave 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/2015.8.13
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2015.8.13/SALTSTACK-GPG-KEY.pub[saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2015.8.13
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2015.8.13/SALTSTACK-GPG-KEY.pub[saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2015.8.13
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2015.8.13/SALTSTACK-EL5-GPG-KEY.pubRun sudo yum clean expire-cache
sudo yum install salt-mastersudo yum install salt-minionsudo yum install salt-sshsudo yum install salt-syndicsudo yum install salt-cloudsudo yum install salt-apiPost-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/2015.8 xenial maindeb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/2015.8 trusty maindeb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/2015.8 precise mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apiPost-installation configuration
Installs the 2015.8.13 release. Updating doesn’t change the release that is installed.
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2015.8.13 xenial maindeb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2015.8.13 trusty maindeb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2015.8.13 precise mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apiPost-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
Prerequisites: Ensure that libgit2-devel and python-devel are installed or Salt will not work after installation:
sudo zypper install libgit2-devel python-develPrerequisites: If using salt-cloud, also install python-apache-libcloud and python-lxml:
sudo zypper install python-apache-libcloud python-lxmlsudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12/systemsmanagement:saltstack.reposudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12/systemsmanagement:saltstack.reposudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_11_SP4/systemsmanagement:saltstack.reposudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_13.2/systemsmanagement:saltstack.reposudo zypper addrepo http://repo.saltstack.com/opensuse/openSUSE_Leap_42.1/systemsmanagement:saltstack.repoRefresh the package list:
sudo zypper refreshsudo zypper install salt-master=2015.8.10-76.5sudo zypper install salt-minion=2015.8.10-76.5sudo zypper install salt-ssh=2015.8.10-76.5sudo zypper install salt-syndic=2015.8.10-76.5sudo zypper install salt-cloud=2015.8.10-76.5sudo zypper install salt-api=2015.8.10-76.5sudo zypper install salt-proxy=2015.8.10-76.5sudo zypper install salt-master=2015.8.10-76.1sudo zypper install salt-minion=2015.8.10-76.1sudo zypper install salt-ssh=2015.8.10-76.1sudo zypper install salt-syndic=2015.8.10-76.1sudo zypper install salt-cloud=2015.8.10-76.1sudo zypper install salt-api=2015.8.10-76.1sudo zypper install salt-proxy=2015.8.10-76.1Post-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
wget -O - https://repo.saltstack.com/apt/suse/14.04/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/2015.8/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/suse/14.04/amd64/2015.8 trusty maindeb http://repo.saltstack.com/apt/suse/12.04/amd64/2015.8 precise mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apisudo apt-get install salt-apiPost-installation configuration
Installs the 2015.8.13 release. Updating doesn’t change the release that is installed.
wget -O - https://repo.saltstack.com/apt/suse/14.04/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/archive/2015.8.13/SALTSTACK-GPG-KEY.pub | sudo apt-key add -/etc/apt/sources.list.d/saltstack.list:
deb http://repo.saltstack.com/apt/suse/14.04/amd64/archive/2015.8.13 trusty maindeb http://repo.saltstack.com/apt/suse/12.04/amd64/archive/2015.8.13 precise mainRun sudo apt-get update
sudo apt-get install salt-mastersudo apt-get install salt-minionsudo apt-get install salt-sshsudo apt-get install salt-syndicsudo apt-get install salt-cloudsudo apt-get install salt-apiPost-installation configuration
Installation executables:
AMD64: Salt-Minion-2015.8.12-AMD64-Setup.exe | MD5
x86: Salt-Minion-2015.8.12-x86-Setup.exe | MD5
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-2015.8.12-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionnamePost-installation configuration
Installs the latest release from the 2015.8 branch. Updating installs the latest minor release from the 2015.8 branch.
sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-2015.8-2.ami.noarch.rpmRun sudo yum clean expire-cache
sudo yum install salt-mastersudo yum install salt-minionsudo yum install salt-sshsudo yum install salt-syndicsudo yum install salt-cloudsudo yum install salt-apiPost-installation configuration
Installs the 2015.8.13 release. Updating doesn’t change the release that is installed.
Run the following commands to install the SaltStack repository and key:
sudo rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/archive/2015.8.13/SALTSTACK-GPG-KEY.pubSave 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/2015.8.13
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/6/$basearch/archive/2015.8.13/SALTSTACK-GPG-KEY.pubRun sudo yum clean expire-cache
sudo yum install salt-mastersudo yum install salt-minionsudo yum install salt-sshsudo yum install salt-syndicsudo yum install salt-cloudsudo yum install salt-apiPost-installation configuration
For installation on other platforms and alternative installation methods, see the SaltStack Installation Instructions.
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.comFor example:
rsync -vaH --numeric-ids --delete --delete-after --delay-updates rsync://rsync.repo.saltstack.com/saltstack_pkgrepo_full ./fullrepo