You are viewing docs from a branch that is no longer active. You might want to view docs for the 2015.8.x release instead.

OS X¶

Dependency Installation¶

When installing via Homebrew, dependency resolution is handled for you.

brew install saltstack

When using macports, zmq, swig, and pip may need to be installed this way:

sudo port install py-zmq
sudo port install py27-m2crypto
sudo port install py27-crypto
sudo port install py27-msgpack
sudo port install swig-python
sudo port install py-pip

For installs using the OS X system python, pip install needs to use 'sudo':

sudo pip install salt

Salt-Master Customizations¶

To run salt-master on OS X, the root user maxfiles limit must be increased:

sudo launchctl limit maxfiles 4096 8192

And sudo add this configuration option to the /etc/salt/master file:

max_open_files: 8192

Now the salt-master should run without errors:

sudo /usr/local/share/python/salt-master --log-level=all

Post-installation tasks¶

Now go to the Configuring Salt page.