Ubuntu Installation

Installation from the SaltStack Repository

2015.8.0 and later packages for Ubuntu 14 (Trusty) and Ubuntu 12 (Precise) are available in the SaltStack repository.

To install using the SaltStack repository:

  1. Run the following command to import the SaltStack repository key:

    Ubuntu 14:

    wget -O - https://repo.saltstack.com/apt/ubuntu/ubuntu14/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    

    Ubuntu 12:

    wget -O - https://repo.saltstack.com/apt/ubuntu/ubuntu12/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
    
  2. Add the following line to /etc/apt/sources.list:

    Ubuntu 14:

    deb http://repo.saltstack.com/apt/ubuntu/ubuntu14 trusty main
    

    Ubuntu 12:

    deb http://repo.saltstack.com/apt/ubuntu/ubuntu12 precise main
    
  3. Run sudo apt-get update.

  4. Install the salt-minion, salt-master, or other Salt components:

    • apt-get install salt-master
    • apt-get install salt-minion
    • apt-get install salt-ssh
    • apt-get install salt-syndic

Post-installation tasks

Now, go to the Configuring Salt page.

Installation from the Community Repository

Packages for Ubuntu are also published in the saltstack PPA. If you have the add-apt-repository utility, you can add the repository and import the key in one step:

sudo add-apt-repository ppa:saltstack/salt

In addition to the main repository, there are secondary repositories for each individual major release. These repositories receive security and point releases but will not upgrade to any subsequent major release. There are currently several available repos: salt16, salt17, salt2014-1, salt2014-7, salt2015-5. For example to follow 2015.5.x releases:

sudo add-apt-repository ppa:saltstack/salt2015-5

add-apt-repository: command not found?

The add-apt-repository command is not always present on Ubuntu systems. This can be fixed by installing python-software-properties:

sudo apt-get install python-software-properties

The following may be required as well:

sudo apt-get install software-properties-common

Note that since Ubuntu 12.10 (Raring Ringtail), add-apt-repository is found in the software-properties-common package, and is part of the base install. Thus, add-apt-repository should be able to be used out-of-the-box to add the PPA.

Alternately, manually add the repository and import the PPA key with these commands:

echo deb http://ppa.launchpad.net/saltstack/salt/ubuntu `lsb_release -sc` main | sudo tee /etc/apt/sources.list.d/saltstack.list
wget -q -O- "http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x4759FA960E27C0A6" | sudo apt-key add -

After adding the repository, update the package management database:

sudo apt-get update

Install packages

Install the Salt master, minion, or syndic from the repository with the apt-get command. These examples each install one daemon, but more than one package name may be given at a time:

  • apt-get install salt-master
  • apt-get install salt-minion
  • apt-get install salt-ssh
  • apt-get install salt-syndic

Post-installation tasks

Now go to the Configuring Salt page.

Docs for previous releases are available on readthedocs.org.

Latest Salt release: 2015.8.0

Table Of Contents

Previous topic

Solaris

Next topic

Windows