Installation with pip or from source

You must have the Python pip tool on your system to proceed with installation.

If your system does not yet include the Python pip tool, here is an installation reminder.

For Debian-like Linux
# Python 2
sudo apt install python-pip

# Python 3
sudo apt install python3-pip

For RHEL-like Linux

On a RHEL (CentOS, Oracle Linux,…), the Python pip installer tool is not included in the standard RHEL repositories but it is part of the EPEL repository. You must enable EPEL repository to install pip.

sudo yum install epel-release
sudo yum -y update

# Python 2
sudo yum install python-pip

# Python 3
sudo yum install python3-pip


# On some older versions, it may be necessary to install extra compiler tools for the python *psutil* package::
sudo yum install gcc python-devel

For FreeBSD:

# Python 2.7
sudo pkg install py27-pip

# Python 3.6
sudo pkg install py36-pip

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