2015-09-14 21:17:59 +00:00
|
|
|
.. _installation-debian:
|
|
|
|
|
|
2016-02-26 11:30:22 +00:00
|
|
|
===========================
|
|
|
|
|
Debian GNU/Linux / Raspbian
|
|
|
|
|
===========================
|
|
|
|
|
|
2016-06-02 14:50:47 +00:00
|
|
|
Debian GNU/Linux distribution and some derivatives such as Raspbian already
|
2016-02-26 11:30:22 +00:00
|
|
|
have included Salt packages to their repositories. However, current stable
|
|
|
|
|
release codenamed "Jessie" contains old outdated Salt release. It is
|
|
|
|
|
recommended to use SaltStack repository for Debian as described
|
|
|
|
|
:ref:`below <installation-debian-repo>`.
|
|
|
|
|
|
|
|
|
|
Installation from official Debian and Raspbian repositories is described
|
|
|
|
|
:ref:`here <installation-debian-raspbian>`.
|
2012-07-05 22:05:20 +00:00
|
|
|
|
2015-09-14 21:17:59 +00:00
|
|
|
.. _installation-debian-repo:
|
|
|
|
|
|
2016-03-23 20:00:30 +00:00
|
|
|
Installation from the Official SaltStack Repository
|
|
|
|
|
===================================================
|
2015-09-14 21:17:59 +00:00
|
|
|
|
2017-09-21 02:41:08 +00:00
|
|
|
Packages for Debian 9 (Stretch) and Debian 8 (Jessie) are available in the
|
2016-03-23 20:00:30 +00:00
|
|
|
Official SaltStack repository.
|
2015-09-14 21:17:59 +00:00
|
|
|
|
2016-06-15 17:52:02 +00:00
|
|
|
Instructions are at https://repo.saltstack.com/#debian.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Regular security support for Debian 7 ended on April 25th 2016. As a result,
|
|
|
|
|
2016.3.1 and 2015.8.10 will be the last Salt releases for which Debian
|
|
|
|
|
7 packages are created.
|
2012-12-20 16:05:17 +00:00
|
|
|
|
2016-02-26 11:30:22 +00:00
|
|
|
.. _installation-debian-raspbian:
|
|
|
|
|
|
|
|
|
|
Installation from the Debian / Raspbian Official Repository
|
|
|
|
|
===========================================================
|
2016-02-24 15:48:37 +00:00
|
|
|
|
|
|
|
|
Stretch (Testing) and Sid (Unstable) distributions are already contain mostly
|
2016-02-25 09:04:11 +00:00
|
|
|
up-to-date Salt packages built by Debian Salt Team. You can install Salt
|
|
|
|
|
components directly from Debian.
|
|
|
|
|
|
2016-02-26 13:10:37 +00:00
|
|
|
On Jessie (Stable) there is an option to install Salt minion from Stretch with
|
|
|
|
|
`python-tornado` dependency from `jessie-backports` repositories.
|
|
|
|
|
|
|
|
|
|
To install fresh release of Salt minion on Jessie:
|
|
|
|
|
|
|
|
|
|
#. Add `jessie-backports` and `stretch` repositories:
|
|
|
|
|
|
|
|
|
|
**Debian**:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
echo 'deb http://httpredir.debian.org/debian jessie-backports main' >> /etc/apt/sources.list
|
|
|
|
|
echo 'deb http://httpredir.debian.org/debian stretch main' >> /etc/apt/sources.list
|
|
|
|
|
|
|
|
|
|
**Raspbian**:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
echo 'deb http://archive.raspbian.org/raspbian/ stretch main' >> /etc/apt/sources.list
|
|
|
|
|
|
|
|
|
|
#. Make Jessie a default release:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
echo 'APT::Default-Release "jessie";' > /etc/apt/apt.conf.d/10apt
|
|
|
|
|
|
|
|
|
|
#. Install Salt dependencies:
|
|
|
|
|
|
2016-02-29 09:42:15 +00:00
|
|
|
**Debian**:
|
2016-03-01 15:36:23 +00:00
|
|
|
|
2016-02-29 09:42:15 +00:00
|
|
|
.. code-block:: bash
|
2016-03-01 15:36:23 +00:00
|
|
|
|
2016-02-29 09:42:15 +00:00
|
|
|
apt-get update
|
2017-01-24 22:25:45 +00:00
|
|
|
apt-get install python-zmq python-systemd/jessie-backports python-tornado/jessie-backports salt-common/stretch
|
2016-02-29 09:42:15 +00:00
|
|
|
|
|
|
|
|
**Raspbian**:
|
2016-03-01 15:36:23 +00:00
|
|
|
|
2016-02-26 13:10:37 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
apt-get update
|
2016-02-29 06:20:51 +00:00
|
|
|
apt-get install python-zmq python-tornado/stretch salt-common/stretch
|
2016-02-26 13:10:37 +00:00
|
|
|
|
|
|
|
|
#. Install Salt minion package from Stretch:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
|
|
|
|
|
apt-get install salt-minion/stretch
|
|
|
|
|
|
2016-02-25 09:04:11 +00:00
|
|
|
.. _debian-install-pkgs:
|
|
|
|
|
|
|
|
|
|
Install Packages
|
|
|
|
|
================
|
2016-02-24 15:48:37 +00:00
|
|
|
|
2016-02-25 09:04:11 +00:00
|
|
|
Install the Salt master, minion or other packages from the repository with
|
|
|
|
|
the `apt-get` command. These examples each install one of Salt components, but
|
|
|
|
|
more than one package name may be given at a time:
|
2016-02-24 15:48:37 +00:00
|
|
|
|
2016-02-25 09:04:11 +00:00
|
|
|
- ``apt-get install salt-api``
|
|
|
|
|
- ``apt-get install salt-cloud``
|
|
|
|
|
- ``apt-get install salt-master``
|
|
|
|
|
- ``apt-get install salt-minion``
|
|
|
|
|
- ``apt-get install salt-ssh``
|
|
|
|
|
- ``apt-get install salt-syndic``
|
2016-02-24 15:48:37 +00:00
|
|
|
|
2016-02-25 09:04:11 +00:00
|
|
|
.. _debian-config:
|
2013-01-25 19:33:43 +00:00
|
|
|
|
|
|
|
|
Post-installation tasks
|
2016-02-24 15:30:51 +00:00
|
|
|
=======================
|
2013-01-25 19:33:43 +00:00
|
|
|
|
2016-12-15 23:50:16 +00:00
|
|
|
Now, go to the :ref:`Configuring Salt <configuring-salt>` page.
|
