FreeBSD#

Salt is available in the FreeBSD ports tree at sysutils/py-salt.

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

Before you start#

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

Install Salt on FreeBSD#

To install the stable release of Salt from the official package repository:

  1. Check which version is the default version of Python for Salt on FreeBSD. See Support for Python versions for more information.

  2. Run the following command, substituting the version of Python as needed. For example, to install for Python 3.8:

    pkg install py38-salt
    
  3. To activate the master in /etc/rc.conf:

    sysrc salt_master_enable="YES"
    
  4. To start the master service:

    service salt_master start
    
  5. To activate the minion in /etc/rc.conf:

    sysrc salt_minion_enable="YES"
    
  6. To start the minion service:

    service salt_minion start
    

    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 from FreeBSD ports#

To install from FreeBSD ports:

  1. Run the following commands:

    cd /usr/ports/sysutils/py-salt
    make install
    

    Note

    Python 3.7 can be used by setting default Python version to 3.7: echo "DEFAULT_VERSIONS+= python=3.7" >> /etc/make.conf

    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: