Download and install the 2016.11 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 page contains instructions to download and install the 2016.11 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: 2016.11.10 (October 24, 2018)
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 -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.
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
Installs the latest release. Updating installs the latest release even if it is a new major version.
Final 2016.11 Release of Debian 7 Packages
Due to the release of Debian 9 and Debian 8 becoming oldstable, 2016.11.5 is the last Salt release for which Debian 7 packages are created.
Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2016.11.5
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.
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/apt/debian/8/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - http://repo.saltstack.com/apt/debian/7/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/9/amd64/latest stretch main
deb http://repo.saltstack.com/apt/debian/8/amd64/latest jessie main
deb http://repo.saltstack.com/apt/debian/7/amd64/latest wheezy main
Run sudo apt-get update
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 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.
Final 2016.11 Release of Debian 7 Packages
Due to the release of Debian 9 and Debian 8 becoming oldstable, 2016.11.5 is the last Salt release for which Debian 7 packages are created.
Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2016.11.5
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.
wget -O - https://repo.saltstack.com/apt/debian/9/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/debian/8/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - http://repo.saltstack.com/apt/debian/7/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/9/amd64/2016.11 stretch main
deb http://repo.saltstack.com/apt/debian/8/amd64/2016.11 jessie main
deb http://repo.saltstack.com/apt/debian/7/amd64/2016.11 wheezy main
Run sudo apt-get update
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 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.
Final 2016.11 Release of Debian 7 Packages
Due to the release of Debian 9 and Debian 8 becoming oldstable, 2016.11.5 is the last Salt release for which Debian 7 packages are created.
Read Before Upgrading Debian 7 (Wheezy) from 2015.8.7 to 2016.11.5
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.
wget -O - https://repo.saltstack.com/apt/debian/9/amd64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/debian/8/amd64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - http://repo.saltstack.com/apt/debian/7/amd64/archive/2016.11.5/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/9/amd64/archive/2016.11.10 stretch main
deb http://repo.saltstack.com/apt/debian/8/amd64/archive/2016.11.10 jessie main
deb http://repo.saltstack.com/apt/debian/7/amd64/archive/2016.11.5 wheezy main
Run sudo apt-get update
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 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 release even if it is a new major version.
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Final 2016.11 Release of Redhat 5 Packages
Production Phase 3 Support for Redhat 5 will end on March 31 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Redhat 5 packages are created
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-latest-2.el7.noarch.rpm
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-latest-2.el7.noarch.rpm
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-latest-2.el6.noarch.rpm
wget https://repo.saltstack.com/yum/redhat/salt-repo-latest-1.el5.noarch.rpm
sudo rpm -ivh salt-repo-latest-1.el5.noarch.rpm
rm -f salt-repo-latest-1.el5.noarch.rpm
Run sudo yum clean expire-cache
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
sudo systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest minor release but not a new major version.
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Final 2016.11 Release of Redhat 5 Packages
Production Phase 3 Support for Redhat 5 will end on March 31 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Redhat 5 packages are created
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2016.11-2.el7.noarch.rpm
sudo yum install https://repo.saltstack.com/yum/redhat/salt-repo-2016.11-2.el6.noarch.rpm
wget https://repo.saltstack.com/yum/redhat/salt-repo-2016.11-1.el5.noarch.rpm
sudo rpm -ivh salt-repo-2016.11-1.el5.noarch.rpm
rm -f salt-repo-2016.11-1.el5.noarch.rpm
Run sudo yum clean expire-cache
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
sudo systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs a specific release. Updating doesn’t change the release that is installed.
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Known issue with Redhat packages when FIPS mode enabled
Currently there is a known issue with RedHat packages when FIPS mode is enabled. The issue is documented in detail here. When installing versions 2016.11.4 and above the salt-minion will not start. This is an upstream bug with pycryptodome and a bug has been filed here. The current workaround is to remove python-pycryptodomex and install python-crypto.
rpm -e --nodeps python2-pycryptodomex
yum install python-crypto
Final 2016.11 Release of Redhat 5 Packages
Production Phase 3 Support for Redhat 5 will end on March 31 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Redhat 5 packages are created
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.11.10/SALTSTACK-GPG-KEY.pub
sudo rpm --import https://repo.saltstack.com/yum/redhat/6/x86_64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub
wget https://repo.saltstack.com/yum/redhat/5/x86_64/archive/2016.11.3/SALTSTACK-EL5-GPG-KEY.pub
sudo rpm --import SALTSTACK-EL5-GPG-KEY.pub
rm -f SALTSTACK-EL5-GPG-KEY.pub
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.11.10
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.11.10/SALTSTACK-GPG-KEY.pub
[saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.11.10
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.11.10/SALTSTACK-GPG-KEY.pub
[saltstack-repo]
name=SaltStack repo for RHEL/CentOS $releasever
baseurl=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.11.3
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/redhat/$releasever/$basearch/archive/2016.11.3/SALTSTACK-EL5-GPG-KEY.pub
Run sudo yum clean expire-cache
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
sudo systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest release even if it is a new major version.
Final 2016.11 Release of Ubuntu 12 Packages
End of Life Support for Ubuntu 12 will end in April 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Ubuntu 12 packages are created
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/apt/ubuntu/14.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/latest/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/latest xenial main
deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/latest trusty main
deb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/latest precise main
Run sudo apt-get update
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 systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest minor release but not a new major version.
Final 2016.11 Release of Ubuntu 12 Packages
End of Life Support for Ubuntu 12 will end in April 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Ubuntu 12 packages are created
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/2016.11/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/2016.11 xenial main
deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/2016.11 trusty main
deb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/2016.11 precise main
Run sudo apt-get update
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 systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs a specific release. Updating doesn’t change the release that is installed.
Final 2016.11 Release of Ubuntu 12 Packages
End of Life Support for Ubuntu 12 will end in April 2017. As a result, 2016.11.3 will be the last Salt release on this branch for which Ubuntu 12 packages are created
wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2016.11.3/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/2016.11.10 xenial main
deb http://repo.saltstack.com/apt/ubuntu/14.04/amd64/archive/2016.11.10 trusty main
deb http://repo.saltstack.com/apt/ubuntu/12.04/amd64/archive/2016.11.3 precise main
Run sudo apt-get update
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 systemctl restart salt-minion
sudo service salt-minion restart
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest release even if it is a new major version.
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
sudo zypper addrepo http://repo.saltstack.com/opensuse/SLE_12_SP1/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
Refresh the package list:
sudo zypper refresh
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
sudo systemctl restart salt-minion
or
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest minor release but not a new major version.
wget -O - https://repo.saltstack.com/apt/suse/14.04/amd64/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/2016.11/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/2016.11 trusty main
deb http://repo.saltstack.com/apt/suse/12.04/amd64/2016.11 precise main
Run sudo apt-get update
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
sudo systemctl restart salt-minion
or
sudo service salt-minion restart
Post-installation configuration
Installs a specific release. Updating doesn’t change the release that is installed.
wget -O - https://repo.saltstack.com/apt/suse/14.04/amd64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
wget -O - https://repo.saltstack.com/apt/suse/12.04/amd64/archive/2016.11.10/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/2016.11.10 trusty main
deb http://repo.saltstack.com/apt/suse/12.04/amd64/archive/2016.11.10 precise main
Run sudo apt-get update
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 systemctl restart salt-minion
or
sudo service salt-minion restart
Post-installation configuration
Installs the latest release. Updating installs the latest release even if it is a new major version.
The 2016.11 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.
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.
The 2016.11 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.
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.
The 2016.11 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.
sudo dnf install salt-master-2016.11.5
sudo dnf install salt-minion-2016.11.5
sudo dnf install salt-ssh-2016.11.5
sudo dnf install salt-syndic-2016.11.5
sudo dnf install salt-cloud-2016.11.5
sudo dnf install salt-api-2016.11.5
Post-installation configuration
Installation executables:
AMD64: Salt-Minion-2016.11.10-AMD64-Setup.exe | MD5 | SHA256
x86: Salt-Minion-2016.11.10-x86-Setup.exe | MD5 | SHA256
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.11.10-AMD64-Setup.exe /S /master=yoursaltmaster /minion-name=yourminionname
Post-installation configuration
salt-2016.11.10-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
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
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
WARNING: If using an Amazon Linux version previous to 2015.03 or a Salt version previous to 2016.11.0 you will need to use the RedHat 6 packages documented on this page. For Salt 2016.11 and above please use the instructions below which provide Amazon Linux native rpms.
If upgrading from the RedHat 6 packages you need to remove all previous packages due to some package conflicts. To remove the packages and dependencies run the following command:
sudo yum autoremove <packagename>
Replacing packagename with the name of the Salt packages you intend to upgrade. To uninstall all Salt packages you can run the following command:
sudo yum autoremove salt salt-master salt-cloud salt-ssh salt-syndic salt-api salt-minion
After uninstalling previous RedHat 6 packages you can continue with the instructions below to upgrade to the latest amazon native rpm packages.
Installs the latest release. Updating installs the latest release even if it is a new major version.
sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-latest-2.amzn1.noarch.rpm
Run sudo yum clean expire-cache
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
sudo service salt-minion restart
Post-installation configuration
WARNING: If using an Amazon Linux version previous to 2015.03 or a Salt version previous to 2016.11.0 you will need to use the RedHat 6 packages documented on this page. For Salt 2016.11 and above please use the instructions below which provide Amazon Linux native rpms.
If upgrading from the RedHat 6 packages you need to remove all previous packages due to some package conflicts. To remove the packages and dependencies run the following command:
sudo yum autoremove <packagename>
Replacing packagename with the name of the Salt packages you intend to upgrade. To uninstall all Salt packages you can run the following command:
sudo yum autoremove salt salt-master salt-cloud salt-ssh salt-syndic salt-api salt-minion
After uninstalling previous RedHat 6 packages you can continue with the instructions below to upgrade to the latest amazon native rpm packages.
Installs the latest release. Updating installs the latest minor release but not a new major version.
sudo yum install https://repo.saltstack.com/yum/amazon/salt-amzn-repo-2016.11-1.amzn1.noarch.rpm
Run sudo yum clean expire-cache
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
sudo service salt-minion restart
Post-installation configuration
WARNING: If using an Amazon Linux version previous to 2015.03 or a Salt version previous to 2016.11.0 you will need to use the RedHat 6 packages documented on this page. For Salt 2016.11 and above please use the instructions below which provide Amazon Linux native rpms.
If upgrading from the RedHat 6 packages you need to remove all previous packages due to some package conflicts. To remove the packages and dependencies run the following command:
sudo yum autoremove <packagename>
Replacing packagename with the name of the Salt packages you intend to upgrade. To uninstall all Salt packages you can run the following command:
sudo yum autoremove salt salt-master salt-cloud salt-ssh salt-syndic salt-api salt-minion
After uninstalling previous RedHat 6 packages you can continue with the instructions below to upgrade to the latest amazon native rpm packages.
Installs a specific 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/amazon/latest/x86_64/archive/2016.11.10/SALTSTACK-GPG-KEY.pub
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/amazon/latest/$basearch/archive/2016.11.10
failovermethod=priority
priority=10
enabled=1
gpgcheck=1
gpgkey=https://repo.saltstack.com/yum/amazon/latest/$basearch/archive/2016.11.10/SALTSTACK-GPG-KEY.pub
Run sudo yum clean expire-cache
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
sudo service salt-minion restart
Post-installation configuration
Raspbian was tested on Pi-2 and Pi-3. Raspbian is based on Debian 8 (jessie).
Installs the latest release. Updating installs the latest release even if it is a new major version.
wget -O - https://repo.saltstack.com/apt/debian/8/armhf/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/8/armhf/latest jessie main
Run sudo apt-get update
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 systemctl restart salt-minion
Post-installation configuration
Installs the latest release. Updating installs the latest minor release but not a new major version.
wget -O - https://repo.saltstack.com/apt/debian/8/armhf/2016.11/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/8/armhf/2016.11 jessie main
Run sudo apt-get update
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 systemctl restart salt-minion
Post-installation configuration
Installs a specific release. Updating doesn’t change the release that is installed.
wget -O - https://repo.saltstack.com/apt/debian/8/armhf/archive/2016.11.10/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
/etc/apt/sources.list.d/saltstack.list
:
deb http://repo.saltstack.com/apt/debian/8/armhf/archive/2016.11.10 jessie main
Run sudo apt-get update
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 systemctl restart salt-minion
Post-installation configuration
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
For installation on other platforms and alternative installation methods, see the SaltStack Installation Instructions.