2.2.9. Ubuntu Installation

2.2.9.1. Add repository

The latest packages for Ubuntu are 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

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

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

2.2.9.2. 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:

sudo apt-get install salt-master
sudo apt-get install salt-minion
sudo apt-get install salt-syndic

2.2.9.3. ZeroMQ 4

We recommend using ZeroMQ 4 where available. ZeroMQ 4 is already available for Ubuntu 14.04 and Ubuntu 14.10 and nothing additional needs to be done. However, the chris-lea/zeromq PPA can be used to provide ZeroMQ 4 on Ubuntu 12.04 LTS. Adding this PPA can be done with a pkgrepo.managed state.

zeromq-ppa:
  pkgrepo.managed:
    - ppa: chris-lea/zeromq

The following states can be used to upgrade ZeroMQ and pyzmq, and then restart the minion:

update_zmq:
  pkg.latest:
    - pkgs:
      - zeromq
      - python-zmq
    - order: last
  cmd.wait:
    - name: |
        echo service salt-minion restart | at now + 1 minute
    - watch:
      - pkg: update_zmq

Note

This example assumes that atd is installed and running, see here for a more detailed explanation.

If this repo is added before Salt is installed, then installing either salt-master or salt-minion will automatically pull in ZeroMQ 4.0.4, and additional states to upgrade ZeroMQ and pyzmq are unnecessary.

2.2.9.4. Post-installation tasks

Now go to the Configuring Salt page.

Docs for previous releases are available on salt.rtfd.org.

Latest Salt release: 2014.7.1

Table Of Contents

Previous topic

2.2.8. Solaris

Next topic

2.2.10. Windows

SaltStack News

Upcoming SaltStack events, webinars and local meet ups and user groups.