Platform agnostic installation (pip)¶
The Salt Project provides public repositories for packages on the public Broadcom Artifactory endpoint:
The preferred method for installing Salt is using distribution packages. This method ensures that:
All dependencies are met.
Salt is installed in a tested and distribution-aligned way.
Note
Salt is often distributed in split packages, but only the salt-master
and salt-minion packages are required for Salt to function. If only
desiring to run Salt in a masterless setup, then only salt-minion is
required.
About platform agonistic installation¶
Warning
Installing salt via pip only has reasonable-effort support..
For more information, see Support for Python versions
Salt can be installed in a platform-agnostic way using the Python package
installer pip from pypi.org.
You can also use pip to install other packages that will complement your Salt
code.
A benefit of using pip is the ability to install Salt in Python virtual
environments and Conda environments.
Warning
If you pip install a library using the salt-pip install method, the Python
package installs into the onedir file location. Any scripts installed by the
Python library will not be accessible from the usual system Python paths.
Scripts installed by the Python library need to be called directly using the
full path to the command.
Install Salt using pip¶
Install package:
pip3 install salt
Note
You can use
pipandpip3interchangeably, depending on the platform’s support for Python 3.