CentOS#

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

Install Salt on CentOS Stream 9 x86_64
Install Salt on CentOS Stream 9 aarch64 and arm64
Install Salt on CentOS Stream 8 x86_64
Install Salt on CentOS Stream 8 aarch64 and arm64
Install Salt on CentOS 7 x86_64
Install Salt on CentOS 7 aarch64 and arm64

What is onedir?

Onedir is the Salt Project’s new packaging system. Onedir packages of Salt include the version of Python needed to run Salt and Salt’s required dependencies.

Beginning with the release of Salt 3006 (Sulfur), the Salt Project has phased out classic package builds for supported operating systems. Update your Salt infrastructure to the onedir packages as soon as possible. See Upgrade to onedir for more information.

Before you start#

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

Install Salt on CentOS Stream 9 x86_64#

To install the Onedir packages of Salt on Centos 9 for x86_64 architecture:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 9 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 9 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 9 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/x86_64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Install Salt on CentOS Stream 9 aarch64 and arm64#

To install the Onedir packages of Salt on Centos 9 for aarch64 and arm64 architectures:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 9 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/arm64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 9 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/arm64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 9 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 9:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/9/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/9/arm64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Install Salt on CentOS Stream 8 x86_64#

To install the Onedir packages of Salt on Centos 8 for x86_64 architecture:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 8 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 8 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 8 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/x86_64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Install Salt on CentOS Stream 8 aarch64 and arm64#

To install the Onedir packages of Salt on Centos 8 for aarch64 and arm64 architectures:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 8 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/arm64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 8 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/arm64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 8 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 8:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/8/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/8/arm64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Install Salt on CentOS 7 x86_64#

To install Salt on CentOS 7 for x86_64 architecture:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 7 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 7 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/x86_64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 7 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/x86_64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

Enable and start service 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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Install Salt on CentOS 7 aarch64 and arm64#

To install Salt on CentOS 7 for aarch64 and arm64 architectures:

Run the following commands to install the Salt Project repository and key:

Click the tab for the Salt version you would like to pin for updates:
CentOS 7 (Latest onedir)
To pin your Salt upgrades to the Latest Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/arm64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 7 (Major onedir)
To pin your Salt upgrades to the Major Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/arm64/3007.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
CentOS 7 (Minor onedir)
To pin your Salt upgrades to the Minor Onedir package of Salt for CentOS 7:
```
sudo rpm --import https://repo.saltproject.io/salt/py3/redhat/7/arm64/SALT-PROJECT-GPG-PUBKEY-2023.pub
curl -fsSL https://repo.saltproject.io/salt/py3/redhat/7/arm64/minor/3007.0.repo | sudo tee /etc/yum.repos.d/salt.repo
```
GPG key change

The GPG key for the 3007.0 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.
Run sudo yum clean expire-cache to clear the repository metadata.

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

sudo yum install salt-master
sudo yum install salt-minion
sudo yum install salt-ssh
sudo yum install salt-syndic
sudo yum install salt-cloud
sudo yum install salt-api

Enable and start service 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
```
Note

When you install a onedir version of Salt (3006 and later), Salt installs its own local version of Python and the dependencies needed for the core functionality of Salt.

After installing a onedir verison of Salt, your system has both a global version of Python at the system level and a local version of Python used by Salt. This architecture change means that the Salt onedir paths for Python are different and you need to change how you install third-party Python dependencies that you use with Salt, including your state files. See Install dependencies for more information.

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

Browse the repo#

Browse the repo for CentOS packages

CentOS 3007.0