Photon OS#

These instructions explain how to install Salt on Photon OS operating systems.

Before you start#

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

Install Salt on Photon OS 5#

To install Salt on Photon OS 5:

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

    To pin your Salt upgrades to the Latest Onedir package of Salt for Photon OS 5:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Major Onedir package of Salt for Photon OS 5:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/3006.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Minor Onedir package of Salt for Photon OS 5:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/5.0/x86_64/minor/3006.7.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

  2. Install packages from the Photon OS repository, such as the salt-minion, salt-master, or other Salt components:

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

    To install the latest release of Salt packages that are available in the Photon OS repository, run these commands:

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

    The following is an example of how to install a specific release of Salt based on the list of packages available in the Photon OS repository:

    sudo tdnf install salt3-master-3005-1.ph5
    sudo tdnf install salt3-minion-3005-1.ph5
    sudo tdnf install salt3-ssh-3005-1.ph5
    sudo tdnf install salt3-syndic-3005-1.ph5
    sudo tdnf install salt3-cloud-3005-1.ph5
    sudo tdnf install salt3-api-3005-1.ph5
    

    Note

    The file extensions are based on which version of Photon OS you are installing Salt services on. For example, the extension for Photon OS 3 is .ph3 and the extension for Photon OS 4 is .ph4.

  3. 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 Photon OS 4#

To install Salt on Photon OS 4:

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

    To pin your Salt upgrades to the Latest Onedir package of Salt for Photon OS 4:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Major Onedir package of Salt for Photon OS 4:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/3006.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Minor Onedir package of Salt for Photon OS 4:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/4.0/x86_64/minor/3006.7.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

  2. Install packages from the Photon OS repository, such as the salt-minion, salt-master, or other Salt components:

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

    To install the latest release of Salt packages that are available in the Photon OS repository, run these commands:

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

    The following is an example of how to install a specific release of Salt based on the list of packages available in the Photon OS repository:

    sudo tdnf install salt3-master-3005-1.ph4
    sudo tdnf install salt3-minion-3005-1.ph4
    sudo tdnf install salt3-ssh-3005-1.ph4
    sudo tdnf install salt3-syndic-3005-1.ph4
    sudo tdnf install salt3-cloud-3005-1.ph4
    sudo tdnf install salt3-api-3005-1.ph4
    

    Note

    The file extensions are based on which version of Photon OS you are installing Salt services on. For example, the extension for Photon OS 3 is .ph3 and the extension for Photon OS 4 is .ph4.

  3. 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 Photon OS 3#

To install Salt on Photon OS 3:

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

    To pin your Salt upgrades to the Latest Onedir package of Salt for Photon OS 3:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/latest.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Major Onedir package of Salt for Photon OS 3:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/latest/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/3006.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

    To pin your Salt upgrades to the Minor Onedir package of Salt for Photon OS 3:

    sudo rpm --import https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/SALT-PROJECT-GPG-PUBKEY-2023.pub
    curl -fsSL https://repo.saltproject.io/salt/py3/photon/3.0/x86_64/minor/3006.7.repo | sudo tee /etc/yum.repos.d/salt.repo
    
    tdnf clean all
    

    GPG key change

    The GPG key for the 3006.7 release is now named: SALT-PROJECT-GPG-PUBKEY-2023. You must import the new GPG key before upgrading or your upgrade will fail.

  2. Install packages from the Photon OS repository, such as the salt-minion, salt-master, or other Salt components:

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

    To install the latest release of Salt packages that are available in the Photon OS repository, run these commands:

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

    The following is an example of how to install a specific release of Salt based on the list of packages available in the Photon OS repository:

    sudo tdnf install salt3-master-3005-1.ph3
    sudo tdnf install salt3-minion-3005-1.ph3
    sudo tdnf install salt3-ssh-3005-1.ph3
    sudo tdnf install salt3-syndic-3005-1.ph3
    sudo tdnf install salt3-cloud-3005-1.ph3
    sudo tdnf install salt3-api-3005-1.ph3
    

    Note

    The file extensions are based on which version of Photon OS you are installing Salt services on. For example, the extension for Photon OS 3 is .ph3 and the extension for Photon OS 4 is .ph4.

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

Browse the repo#

Browse the repo for Photon OS packages

Photon OS 3007.0