Installing/Testing a Salt Release Candidate

It's time for a new feature release of Salt! Follow the instructions below to install the latest release candidate of Salt, and try all the shiny new features! Be sure to report any bugs you find on Github.

Installing Using Packages

Builds for a few platforms are available as part of the RC at https://repo.saltstack.com/salt_rc/.

Note

For RHEL and Ubuntu, Follow the instructions on https://repo.saltstack.com/, but insert salt_rc/ into the URL between the hostname and the remainder of the path. For example:

baseurl=https://repo.saltstack.com/salt_rc/yum/redhat/$releasever/$basearch/
deb http://repo.saltstack.com/salt_rc/apt/ubuntu/14.04/amd64 jessie main

Available builds:

  • Amazon Linux
  • Debian 8
  • macOS
  • RHEL 7
  • SmartOS (see below)
  • Ubuntu 16.04
  • Windows

SmartOS

Release candidate builds for SmartOS are available at http://pkg.blackdot.be/extras/salt-2016.11rc/.

On a base64 2015Q4-x86_64 based native zone the package can be installed by the following:

pfexec pkg_add -U https://pkg.blackdot.be/extras/salt-2016.11rc/salt-2016.11.0rc2_2015Q4_x86_64.tgz

When using the 2016Q2-tools release on the global zone by the following:

pfexec pkg_add -U https://pkg.blackdot.be/extras/salt-2016.11rc/salt-2016.11.0rc2_2016Q2_TOOLS.tgz

Installing Using Bootstrap

You can install a release candidate of Salt using Salt Bootstrap:

curl -o install_salt.sh -L https://bootstrap.saltstack.com
sudo sh install_salt.sh -P git v2016.11.0rc2

If you want to also install a master using Salt Bootstrap, use the -M flag:

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

If you want to install only a master and not a minion using Salt Bootstrap, use the -M and -N flags:

curl -o install_salt.sh -L https://bootstrap.saltstack.com
sudo sh install_salt.sh -P -M -N git v2016.11.0rc2

Installing Using PyPI

Installing from the source archive on PyPI is fairly straightforward.

Note

On RHEL derivatives you also need to install the epel-release package first.

sudo yum install epel-release

First install the build dependencies.

  • Debian-based systems:

    sudo apt-get install python-pip python-dev gcc g++
    
  • RedHat-based systems:

    sudo yum install python-pip python-devel gcc gcc-c++
    
  • other systems:

    You will need to install:

    • pip
    • python header libraries
    • C and C++ compilers

Then install salt using the following command:

sudo pip install salt==2016.11.0rc2

Docs for previous releases are available on readthedocs.org.

Latest Salt release: 2016.11.4

Table Of Contents