Platform agnostic installation (pip)#
The Salt Project provides a public repository for packages at the Salt Project Package Repo.
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.
About platform agonistic installation#
Salt can be installed in a platform-agnostic way using the Python package
installer pip
from pypi.org.
You can 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
pip
andpip3
interchangeably, depending on the platform’s support for Python 3.