Installing SaltStack on macOS is really a pain.

I tried the easy which fail due to a very big problem.

This is the solution

The pain

Homebrew is a pain because they don’t package correctly SaltStack and finally we need to find the right way to fix it.

Never install using:

brew install salt

The fix

Salt isn’t compatible with the actual (default) python from Homebrew.

Install Python

We need Python 3.7 so we install it using the bottled version:

brew install --force-bottle "[email protected]"

Install SaltStack

Finally, we install SaltStack using a fork of the formula which force “Python 3.7” (the right version):

brew install cdalvaro/tap/salt

We firstly installed [email protected] with the bottle to avoid a lost of time due to the compilation of Python 3.7.

It’s done and you’ve finally a functional salt.


If you want to have clean states, you can be interested by salt-lint: A command-line utility that checks for best practices in Salt…