10 Minutes Shinken Installation Guide


By following this tutorial, in 10 minutes you will have the core monitoring system for your network.

The very first step is to verify that your server meets the requirements, the installation script will try to meet all requirements automatically.

You can get familiar with the Shinken Architecture now, or after the installation. This will explain the software components and how they fit together.

Ready? Let’s go!


Mandatory Requirements

  • Python 2.6 or higher (2.7 will get higher performance)
  • python-pycurl Python package for Shinken daemon communication
  • setuptools or distribute Python package for installation

Conditional Requirements

  • Python 2.7 is required for developers to run the test suite, shinken/test/
  • python-cherrypy3 (recommended) enhanceddaemons communications, especially in HTTPS mode
  • Monitoring Plugins (recommended) provides a set of plugins to monitor host (Shinken uses check_icmp by default install). Monitoring plugins are available on most linux distributions (nagios-plugins package)


Do not mix installation methods! If you wish to change method, use the uninstaller from the chosen method THEN install using the alternate method.

GNU/Linux & Unix Installation

Method 1: Pip

Shinken 2.4 is available on Pypi : https://pypi.python.org/pypi/Shinken/2.4 You can download the tarball and execute the setup.py or just use the pip command to install it automatically.

apt-get install python-pip python-pycurl
adduser shinken
pip install shinken

Method 2: Packages

For now the 2.4 packages are not available, but the community is working hard for it! Packages are simple, easy to update and clean. Packages should be available on Debian/Ubuntu and Fedora/RH/CentOS soon (basically .deb and .rpm).

Method 3: Installation from sources

Download last stable Shinken tarball archive (or get the latest git snapshot) and extract it somewhere:

adduser shinken
wget http://www.shinken-monitoring.org/pub/shinken-2.4.tar.gz
tar -xvzf shinken-2.4.tar.gz
cd shinken-2.4
python setup.py install

Shinken 2.X uses LSB path. If you want to stick to one directory installation you can of course. Default paths are the following:

  • /etc/shinken for configuration files
  • /var/lib/shinken for shinken modules, retention files...
  • /var/log/shinken for log files
  • /var/run/shinken for pid files

Windows Installation

For 2.X+ the executable installer may not be provided. Consequently, installing Shinken on a Windows may be manual with setup.py. Steps are basically the same as on Linux (Python install etc.) but in windows environment it’s always a bit tricky.

Read the Docs v: latest
On Read the Docs
Project Home

Free document hosting provided by Read the Docs.