Raspbian#

Raspbian uses the same packages as Debian systems. These instructions explain how to install Salt on Raspbian operating systems:

Browse the repo for Raspbian (Debian) packages

Debian Python3

What is onedir?

Onedir is the Salt Project’s new packaging system. Beginning with the release of Salt 3005 (Phosphorus), the Salt Project will begin replacing the old packaging system with the onedir packaging system.

Onedir packages of Salt include the version of Python needed to run Salt and Salt’s required dependencies.

The Salt Project will support the old packaging system until the 3006 release. See Upgrade to onedir for more information.

Before you start#

Before installing Salt on your operating system, ensure that you first:

Install classic packages of Salt on Raspbian 11 (Bullseye)#

To install the Classic packages of Salt on Raspbian 11 (Bullseye):

  1. Run the following commands to import the Salt Project repository key, and to create the apt sources list file:

    Click the tab for the Salt version you would like to pin for updates:

    To pin your Salt upgrades to the Latest Classic package of Salt for Raspbian 11 (Bullseye):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/armhf/latest/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/11/armhf/latest bullseye main" | sudo tee /etc/apt/sources.list.d/salt.list

    To pin your Salt upgrades to the Major Classic package of Salt for Raspbian 11 (Bullseye):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/armhf/3005/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/11/armhf/3005 bullseye main" | sudo tee /etc/apt/sources.list.d/salt.list

    To pin your Salt upgrades to the Minor Classic package of Salt for Raspbian 11 (Bullseye):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/armhf/archive/3005.1/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/11/armhf/archive/3005.1 bullseye main" | sudo tee /etc/apt/sources.list.d/salt.list

  2. Run sudo apt-get update to update your packages.

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

    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

  4. Enable and start the services for salt-minion, salt-master, or other Salt components:

    sudo systemctl enable salt-master && sudo systemctl start salt-master
sudo systemctl enable salt-minion && sudo systemctl start salt-minion
sudo systemctl enable salt-syndic && sudo systemctl start salt-syndic
sudo systemctl enable salt-api && sudo systemctl start salt-api

After installing Salt on your operating system, you need to complete the following post-installation steps:

Install classic packages of Salt on Raspbian 10 (Buster)#

To install the Classic packages of Salt on Raspbian 10 (Buster):

  1. Run the following commands to import the Salt Project repository key, and to create the apt sources list file:

    Click the tab for the Salt version you would like to pin for updates:

    To pin your Salt upgrades to the Latest Classic package of Salt for Raspbian 10 (Buster):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/10/armhf/latest/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/10/armhf/latest buster main" | sudo tee /etc/apt/sources.list.d/salt.list

    To pin your Salt upgrades to the Major Classic package of Salt for Raspbian 10 (Buster):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/10/armhf/3005/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/10/armhf/3005 buster main" | sudo tee /etc/apt/sources.list.d/salt.list

    To pin your Salt upgrades to the Minor Classic package of Salt for Raspbian 10 (Buster):

    mkdir /etc/apt/keyrings

sudo curl -fsSL -o /etc/apt/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/10/armhf/archive/3005.1/salt-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/salt-archive-keyring.gpg arch=armhf] https://repo.saltproject.io/py3/debian/10/armhf/archive/3005.1 buster main" | sudo tee /etc/apt/sources.list.d/salt.list

  2. Run sudo apt-get update to update your packages.

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

    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

  4. Enable and start the services for salt-minion, salt-master, or other Salt components:

    sudo systemctl enable salt-master && sudo systemctl start salt-master
sudo systemctl enable salt-minion && sudo systemctl start salt-minion
sudo systemctl enable salt-syndic && sudo systemctl start salt-syndic
sudo systemctl enable salt-api && sudo systemctl start salt-api

After installing Salt on your operating system, you need to complete the following post-installation steps: