Debian

These instructions explain how to install Salt on Debian operating systems:

• Install onedir packages of Salt on Debian 11 (Bullseye)
• Install onedir packages of Salt on Debian 10 (Buster)
• Install classic packages of Salt on Debian 11 (Bullseye)
• Install classic packages of Salt on Debian 11 (Bullseye) ARM64
• Install classic packages of Salt on Debian 10 (Buster)

Browse the repo for 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:

• Check system requirements
• Check your network ports
• Check your permissions

Install onedir packages of Salt on Debian 11 (Bullseye)

To install the Onedir packages of Salt on Debian 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:

   Debian 11 (Latest onedir)

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

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

   Debian 11 (Major onedir)

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

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

   Debian 11 (Minor onedir)

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

   sudo curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/salt/py3/debian/11/amd64/minor/3005-1/salt-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/salt/py3/debian/11/amd64/minor/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:

• Configure the Salt master and minions
• Start the master and minion services
• Accept the minion keys
• Verify a Salt install

Install onedir packages of Salt on Debian 10 (Buster)

To install the Onedir packages of Salt on Debian 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:

   Debian 10 (Latest onedir)

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

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

   Debian 10 (Major onedir)

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

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

   Debian 10 (Minor onedir)

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

   sudo curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/salt/py3/debian/10/amd64/minor/3005-1/salt-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/salt/py3/debian/10/amd64/minor/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:

• Configure the Salt master and minions
• Start the master and minion services
• Accept the minion keys
• Verify a Salt install

Install classic packages of Salt on Debian 11 (Bullseye)

Warning

The Salt Project will support the classic, non-onedir packaging system until the 3006 release. After that time, onedir will become the standard packaging system for the Salt Project. The following instructions explain how to install Salt using the classic packaging system, but you should consider upgrading to onedir soon. See Upgrade to onedir for more information.

In order to prevent problems running classic Salt packages, you should run Salt with the default version of Python that was originally packaged with that operating system. For example, RedHat 8 and CentOS 8 should use Python 3.6. Using any other version could prevent Salt from working properly.

To install Salt on Debian 11 (Bullseye) using the old packaging system:

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:

   Debian 11 (Latest classic)

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

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

   Debian 11 (Major classic)

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

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

   Debian 11 (Minor classic)

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

   sudo curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/amd64/archive/3005/salt-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/py3/debian/11/amd64/archive/3005 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:

• Configure the Salt master and minions
• Start the master and minion services
• Accept the minion keys
• Verify a Salt install

Install classic packages of Salt on Debian 11 (Bullseye) ARM64

Warning

The Salt Project will support the classic, non-onedir packaging system until the 3006 release. After that time, onedir will become the standard packaging system for the Salt Project. The following instructions explain how to install Salt using the classic packaging system, but you should consider upgrading to onedir soon. See Upgrade to onedir for more information.

In order to prevent problems running classic Salt packages, you should run Salt with the default version of Python that was originally packaged with that operating system. For example, RedHat 8 and CentOS 8 should use Python 3.6. Using any other version could prevent Salt from working properly.

To install Salt on Debian 11 (Bullseye) ARM64 using the old packaging system:

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:

   Debian 11 ARM64 (Latest classic)

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

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

   Debian 11 ARM64 (Major classic)

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

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

   Debian 11 ARM64 (Minor classic)

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

   sudo curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/11/arm64/archive/3005/salt-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=arm64] https://repo.saltproject.io/py3/debian/11/arm64/archive/3005 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:

• Configure the Salt master and minions
• Start the master and minion services
• Accept the minion keys
• Verify a Salt install

Install classic packages of Salt on Debian 10 (Buster)

Warning

The Salt Project will support the classic, non-onedir packaging system until the 3006 release. After that time, onedir will become the standard packaging system for the Salt Project. The following instructions explain how to install Salt using the classic packaging system, but you should consider upgrading to onedir soon. See Upgrade to onedir for more information.

In order to prevent problems running classic Salt packages, you should run Salt with the default version of Python that was originally packaged with that operating system. For example, RedHat 8 and CentOS 8 should use Python 3.6. Using any other version could prevent Salt from working properly.

To install Salt on Debian 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:

   Debian 10 (Latest classic)

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

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

   Debian 10 (Major classic)

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

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

   Debian 10 (Minor classic)

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

   sudo curl -fsSL -o /usr/share/keyrings/salt-archive-keyring.gpg https://repo.saltproject.io/py3/debian/10/amd64/archive/3005/salt-archive-keyring.gpg
   echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/py3/debian/10/amd64/archive/3005 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:

• Configure the Salt master and minions
• Start the master and minion services
• Accept the minion keys
• Verify a Salt install