Revert to a previous version of Salt

This documentation explains how to revert to a previous version of Salt on these operating systems:

Warning

Salt package repositories do not host versions of Salt older than 3006 LTS. This means users will NOT be able to revert to older versions such as Salt 3005.

Revert Salt on Debian/Ubuntu operating systems

To revert to a previous version of Salt:

  1. Verify the version of Salt you are running. For example:

    salt-call --local test.versions
    salt minion test.version
    salt-run --versions-report
    

    Example output:

    minion:
        3006.9
  2. Run the following commands to remove all Salt services:

    apt-get remove salt-common
    apt-get remove salt-master
    apt-get remove salt-minion
    apt-get remove salt-ssh
    apt-get remove salt-syndic
    apt-get remove salt-cloud
    apt-get remove salt-api
    
  3. Refer to the install directions, and restrict to target LTS or STS available packages via Linux (DEB)

  4. Verify the version of Salt you are running to ensure you are on the previous version. For example:

    salt-call test.version
    salt minion test.version
    salt-run --versions-report
    

Revert Salt on RedHat operating systems

To revert to a previous version of Salt:

  1. Verify the version of Salt you are running. For example:

    salt-call --local test.versions
    salt minion test.version
    salt-run --versions-report
    

    Example output:

    minion:
        3006.9
  2. Run the following command to change your version of Salt and remove all Salt services:

    dnf remove salt
    
  3. Refer to the install directions, and restrict to target LTS or STS available packages via Linux (RPM)

  4. Update your package manager and install any of the Salt services as needed:

    dnf makecache
    dnf install salt-master
    dnf install salt-minion
    dnf install salt-ssh
    dnf install salt-syndic
    dnf install salt-cloud
    dnf install salt-api
    
  5. Restart the salt services:

    systemctl restart salt-master
    systemctl restart salt-minion
    systemctl restart salt-ssh
    systemctl restart salt-syndic
    systemctl restart salt-cloud
    systemctl restart salt-api
    
  6. Verify the version of Salt you are running to ensure you are on the previous version. For example:

    salt-call --local test.versions
    salt minion test.version
    salt-run --versions-report