salt/doc/topics/installation/freebsd.rst
Ari Maniatis b70c45c297
Remove salt FreeBSD repo which is now 2 years out of date
The saltstack repository has the 2016 version is current. Its not being updated, but there is a perfectly good port in the FreeBSD tree to use instead. Enhance the documentation on how to install that from binary or source.
2019-03-14 17:40:18 -04:00

86 lines
1.5 KiB
ReStructuredText

=======
FreeBSD
=======
Installation
============
Salt is available in the FreeBSD ports at `sysutils/py-salt. <https://www.freshports.org/sysutils/py-salt/>`__
FreeBSD binary repo
===================
.. code-block:: bash
pkg install py27-salt
FreeBSD ports
=============
By default salt is packaged using python 2.7, but if you build your own packages from FreeBSD ports either by hand or with poudriere you can instead package it with your choice of python. Add a line to /etc/make.conf to choose your python flavour:
.. code-block:: shell
echo "DEFAULT_VERSIONS+= python=3.6" >> /etc/make.conf
Then build the port and install:
.. code-block:: bash
cd /usr/ports/sysutils/py-salt
make install
Post-installation tasks
=======================
**Master**
Copy the sample configuration file:
.. code-block:: bash
cp /usr/local/etc/salt/master.sample /usr/local/etc/salt/master
**rc.conf**
Activate the Salt Master in ``/etc/rc.conf``:
.. code-block:: bash
sysrc salt_master_enable="YES"
**Start the Master**
Start the Salt Master as follows:
.. code-block:: bash
service salt_master start
**Minion**
Copy the sample configuration file:
.. code-block:: bash
cp /usr/local/etc/salt/minion.sample /usr/local/etc/salt/minion
**rc.conf**
Activate the Salt Minion in ``/etc/rc.conf``:
.. code-block:: bash
sysrc salt_minion_enable="YES"
**Start the Minion**
Start the Salt Minion as follows:
.. code-block:: bash
service salt_minion start
Now go to the :ref:`Configuring Salt<configuring-salt>` page.