Install dependencies

Salt and the Salt services require various packages to be present in order to run effectively. If you host your own custom built repository of Salt, you must also ensure these packages are present in the repository. For example, if your system is air-gapped and uses a minimal repository, these packages must be present in order for the Salt services to run correctly.

The following list the package dependencies for each operating system for onedir packages.

Installing dependencies in onedir versions of Salt

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. See Salt dependencies for a list of packages that come installed with 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.

The recommended approach is to install dependencies is to use Salt to reinstall any existing third-party Python packages. Reinstalling the packages ensures they are in the correct onedir path:

  1. Use salt-call pip.list to view existing modules that may need to be installed.

    Note

    See Salt dependencies for a list of the packages that are installed with onedir. Any package that is not on this list needs to be reinstalled.

  2. You can use two possible methods to reinstall packages:

    • salt-pip install <package name>

    • Use the pip.installed Salt state.

    Note

    In order to install software such as Python libraries and Salt extensions, you’ll need to use salt-pip to install packages into the onedir directory. For more information, see the pip.state module documentation.

  3. After upgrading to onedir, you might need to update any state files that use pip.installed if you need to install Python packages into the system Python environment. In the state file, provide the pip_bin or bin_env to the pip state module.

    For example:

    lib-foo:
  pip.installed:
    - pip_bin: /usr/bin/pip3
lib-bar:
  pip.installed:
    - bin_env: /usr/bin/python3

  4. After upgrading to onedir, you might also need to update any salt gitfs formula branches if the formula has changed because of onedir-specific fixes.

List of dependencies by operating system

Amazon Linux 2

Service

Packages

salt

  • /bin/bash

  • /bin/sh

  • /usr/bin/env

  • config(salt) = 3005.1-2.amzn2

  • dmidecode

  • libc.so.6

  • libdl.so.2

  • libpthread.so.0

  • libz.so.1

  • openssl

  • pciutils

  • rpmlib

  • rtld

  • systemd-units

  • which

salt-minion

  • /bin/bash

  • /bin/sh

  • config(salt-minion) = 3005.1-2.amzn2

  • rpmlib

  • salt = 3005.1

salt-master

  • /bin/bash

  • /bin/sh

  • config(salt-master) = 3005.1-2.amzn2

  • rpmlib

  • salt = 3005.1-2.amzn2

salt-api

  • /bin/bash

  • /bin/sh

  • rpmlib

  • salt-master = 3005.1-2.amzn2

salt-cloud

  • /bin/bash

  • config(salt-cloud) = 3005.1-2.amzn2

  • rpmlib

  • salt-master = 3005.1-2.amzn2

salt-ssh

  • /bin/bash

  • config(salt-ssh) = 3005.1-2.amzn2

  • rpmlib

  • salt = 3005.1-2.amzn2

salt-syndic

  • /bin/bash

  • /bin/sh

  • rpmlib

  • salt-master = 3005.1-2.amzn2

Debian 11

Service

Packages

salt

Recommends:

  • lsb-release

Suggests:

  • ifupdown

salt-minion

Depends:

  • bsdmainutils

  • dctrl-tools

  • salt-common (= 3005.1+ds-2)

Recommends:

  • debconf-utils

  • dmidecode

  • net-tools

salt-master

Depends:

  • salt-common (= 3005.1+ds-2)

salt-api

Depends:

  • salt-master

salt-cloud

Depends:

  • salt-common (= 3005.1+ds-2)

salt-ssh

Depends:

  • salt-common (= 3005.1+ds-2)

  • openssh-client

salt-syndic

Depends:

  • salt-master (= 3005.1+ds-2)

RedHat 7

Service

Packages

salt

  • /bin/bash

  • /bin/sh

  • /usr/bin/env

  • config(salt) = 3005.1-2.el7

  • dmidecode

  • libc.so.6

  • libdl.so.2

  • libpthread.so.0

  • libz.so.1

  • openssl

  • pciutils

  • rpmlib

  • rtld

  • systemd-units

  • which

salt-minion

  • /bin/bash

  • /bin/sh

  • config(salt-minion) = 3005.1-2.el7

  • rpmlib

  • salt = 3005.1-2.el7

salt-master

  • /bin/bash

  • /bin/sh

  • config(salt-master) = 3005.1-2.el7

  • rpmlib

  • salt = 3005.1-2.el7

salt-api

  • /bin/bash

  • /bin/sh

  • config(salt-master) = 3005.1-2.el7

  • rpmlib

  • salt = 3005.1-2.el7

salt-cloud

  • /bin/bash

  • config(salt-cloud) = 3005.1-2.el7

  • rpmlib

  • salt-master = 3005.1-2.el7

salt-ssh

  • /bin/bash

  • config(salt-ssh) = 3005.1-2.el7

  • rpmlib

  • salt = 3005.1-2.el7

salt-syndic

  • /bin/bash

  • /bin/sh

  • rpmlib

  • salt-master = 3005.1-2.el7

RedHat 8

Service

Packages

salt

  • /bin/bash

  • /bin/sh

  • /usr/bin/sh

  • config(salt) = 3005.1-2.el8

  • dmidecode

  • libc.so.6

  • libdl.so.2

  • libpthread.so.0

  • libz.so.1

  • openssl

  • pciutils

  • rpmlib

  • rtld

  • systemd-units

  • which

salt-minion

  • /bin/bash

  • /bin/sh

  • config(salt-minion) = 3005.1-2.el8

  • rpmlib

  • salt = 3005.1-2.el8

salt-master

  • /bin/bash

  • /bin/sh

  • config(salt-master) = 3005.1-2.el8

  • rpmlib

  • salt = 3005.1-2.el8

salt-api

  • /bin/bash

  • /bin/sh

  • rpmlib

  • salt-master = 3005.1-2.el8

salt-cloud

  • /bin/bash

  • config(salt-cloud) = 3005.1-2.el8

  • rpmlib

  • salt-master = 3005.1-2.el8

salt-ssh

  • /bin/bash

  • config(salt-ssh) = 3005.1-2.el8

  • rpmlib

  • salt = 3005.1-2.el8

salt-syndic

  • /bin/bash

  • /bin/sh

  • rpmlib

  • salt-master = 3005.1-2.el8

RedHat 9

Service

Packages

salt

  • /usr/bin/bash

  • /usr/bin/sh

  • config(salt) = 3005.1-2.el9

  • dmidecode

  • libc.so.6

  • libdl.so.2

  • libpthread.so.0

  • libz.so.1

  • openssl

  • pciutils

  • rpmlib

  • rtld

  • systemd-units

  • which

salt-minion

  • /bin/sh

  • /usr/bin/bash

  • config(salt-minion) = 3005.1-2.el9

  • rpmlib

  • salt = 3005.1-2.el9

salt-master

  • /bin/sh

  • /usr/bin/bash

  • config(salt-master) = 3005.1-2.el9

  • rpmlib

  • salt = 3005.1-2.el9

salt-api

  • /bin/sh

  • /usr/bin/bash

  • rpmlib

  • salt-master = 3005.1-2.el9

salt-cloud

  • /usr/bin/bash

  • config(salt-cloud) = 3005.1-2.el9

  • rpmlib

  • salt-master = 3005.1-2.el9

salt-ssh

  • /usr/bin/bash

  • config(salt-ssh) = 3005.1-2.el9

  • rpmlib

  • salt = 3005.1-2.el9

salt-syndic

  • /bin/sh

  • /usr/bin/bash

  • rpmlib

  • salt-master = 3005.1-2.el9

Ubuntu 18.04

Service

Packages

salt

Recommends:

  • lsb-release

Suggests:

  • ifupdown

salt-minion

Depends:

  • bsdmainutils

  • dctrl-tools

  • salt-common (= 3005.1+ds-2)

Recommends:

  • debconf-utils

  • dmidecode

  • net-tools

salt-master

Depends:

  • salt-common (= 3005.1+ds-2)

salt-api

Depends:

  • salt-master

salt-cloud

Depends:

  • salt-common (= 3005.1+ds-2)

salt-ssh

Depends:

  • salt-common (= 3005.1+ds-2)

  • openssh-client

salt-syndic

Depends:

  • salt-master (= 3005.1+ds-2)

Ubuntu 20.04

Service

Packages

salt

Recommends:

  • lsb-release

Suggests:

  • ifupdown

salt-minion

Depends:

  • bsdmainutils

  • dctrl-tools

  • salt-common (= 3005.1+ds-2)

Recommends:

  • debconf-utils

  • dmidecode

  • net-tools

salt-master

Depends:

  • salt-common (= 3005.1+ds-2)

salt-api

Depends:

  • salt-master

salt-cloud

Depends:

  • salt-common (= 3005.1+ds-2)

salt-ssh

Depends:

  • salt-common (= 3005.1+ds-2)

  • openssh-client

salt-syndic

Depends:

  • salt-master (= 3005.1+ds-2)

Ubuntu 22.04

Service

Packages

salt

Recommends:

  • lsb-release

Suggests:

  • ifupdown

salt-minion

Depends:

  • bsdmainutils

  • dctrl-tools

  • salt-common (= 3005.1+ds-2)

Recommends:

  • debconf-utils

  • dmidecode

  • net-tools

salt-master

Depends:

  • salt-common (= 3005.1+ds-2)

salt-api

Depends:

  • salt-master

salt-cloud

Depends:

  • salt-common (= 3005.1+ds-2)

salt-ssh

Depends:

  • salt-common (= 3005.1+ds-2)

  • openssh-client

salt-syndic

Depends:

  • salt-master (= 3005.1+ds-2)