Installation with pip or from source

Alignak system requirements are documented in this chapter. Make sure that your system is complying before trying to install;)

Installation with pip

The installation from the PyPi repository is very simple, use this command:

# Python 2
sudo pip install alignak
# Python 3
sudo pip3 install alignak

This will get and install the most recent alignak package found on your default PyPi configuration.

After the installation, some files are shipped in the /usr/local/share/alignak directory: a default configuration, system service units files, man pages, …

Note

If you wish a specific version, specify the version requirements on the command line: sudo pip install alignak==2.0.0rc3

No matter why, but you may need to reinstall all the Python Alignak dependencies. You can easily do it with this command line:

sudo pip install -r /usr/local/share/alignak/requirements.txt

Tip

The Alignak project team maintains Alignak and all the Alignak related stuff on its PyPI page. All the published versions are available on the PyPI repository and are tagged alignak.

Note

because of some pip specific behavior, installing Alignak requires to be connected as a user (and not as root) to run the pip command. If you really need to install from a root account, use pip install . -v --install-option='--prefix=/usr/local'

Note

the only downside with the pip installation is that the system services are not automatically installed but you can install a posteriori because all necessary files are shipped in the /usr/local/share/alignak/bin directory

Installation from the source

Get the source archive on the project GitHub releases page and uncompress the downloaded file then install with python pip.

# As an exemple, for a version tagged as "1.1.0"
# Use the most recent version from the project releases page ;)
wget https://github.com/Alignak-monitoring/alignak/archive/1.1.0.tar.gz
tar -xvf 1.1.0.tar.gz
cd alignak-1.1.0

sudo pip install -r requirements.txt
sudo pip install .
...
...
Successfully installed ......

To start Alignak as system services, you must install the shipped service units. The procedure is documented here.

Note

because of some pip specific behavior, installing Alignak requires to be connected as a user (and not as root) to run the pip command. If you really need to install from a root account, use pip install . -v --install-option='--prefix=/usr/local'

Note

the only downside with the pip installation is that the system services are not automatically installed but you can install a posteriori because all necessary files are shipped in the /usr/local/share/alignak/bin directory