This section contains instructions to install Salt. If you are setting up your environment for the first time, you should install a Salt master on a dedicated management server or VM, and then install a Salt minion on each system that you want to manage using Salt. For now you don't need to worry about your architecture, you can easily add components and modify your configuration later without needing to reinstall anything.
The general installation process is as follows:
-Moption to install the Salt master.
After this, you should be able to run a simple command and receive returns from all connected Salt minions.
salt '*' test.ping
These guides go into detail how to install Salt on a given platform.
Salt should run on any Unix-like platform so long as the dependencies are met.
Salt defaults to the ZeroMQ transport, and the choice can be made at install time, for example:
python setup.py --salt-transport=raet install
This way, only the required dependencies are pulled by the setup script if need be.
If installing using pip, the
--salt-transport install option can be
pip install --install-option="--salt-transport=raet" salt
Salt does not bundle dependencies that are typically distributed as part of the base OS. If you have unmet dependencies and are using a custom or minimal installation, you might need to install some additional packages from your OS vendor.
When upgrading Salt, the master(s) should always be upgraded first. Backward compatibility for minions running newer versions of salt than their masters is not guaranteed.
Whenever possible, backward compatibility between new masters and old minions will be preserved. Generally, the only exception to this policy is in case of a security vulnerability.
Installing Salt for development and contributing to the project.