Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Flexible and scalable monitoring framework
Python Shell Perl Ruby PHP Makefile Other
Failed to load latest commit information.
bin improve script directory finding in init scripts
cli Fix: exit with error code whan install fail in CLI. Fix #1414
contrib Enh: move *daemons*link(s) code/classes to shinken.objects.
doc Enh: Doc - Add doc for #806
etc Merge pull request #1488 from ReAzem/patch-3
external_commands Clean-up shell-scripts.
for_fedora Fix: (by David Gil) typo an host to a host. related to #1337. Also fi…
inventory Renamed to .gitkeep
libexec Enh: move *daemons*link(s) code/classes to shinken.objects.
manpages Add shinken-discovery manpage and fix other manpages
modules Fix/Enh: changed all bare "except" to "except Exception".
share Fix: get back the share directory so pack and modules can be installe…
shinken Fix : escalated value in notification object #820
test Enh: Test - Case for #820
var Renamed to .gitkeep
.gitignore Fix tests
.pylintrc Enh: Pylintrc no report
.travis.yml Merge remote-tracking branch 'github/master' into setup_py_2_2
COPYING Change licence to AGPLv3. This must not so be important, but I don't …
Changelog TAG: Go 2.4-BETA1 version
FOR_PACKAGERS Update FOR_PACKAGERS Add: Governance to the project Fix missing modules folder in the pip installation
README Rename README to README.rst and add a README symlink
README.rst Merge remote-tracking branch 'github/master' into setup_py_2_2
THANKS Add: Alexandre Viau to the THANKS file Add: move ini files into a etc/daemons directory. Add init scripts in install
requirements.txt Try to fix jenkins unit tests
setup.cfg Merge pull request #1540 from titilambert/ Fix for installation with zip file Fix memory leak in default shinken file generation


Presentation of the Shinken project

Welcome to the Shinken project.


Shinken is a modern, Nagios compatible monitoring framework, written in Python. Its main goal is to give users a flexible architecture for their monitoring system that is designed to scale to large environments.

Shinken is backwards-compatible with the Nagios configuration standard and plugins. It works on any operating system and architecture that supports Python, which includes Windows and GNU/Linux.


See the Documentation

There are mandatory and conditional requirements for the installation methods which are described below.

Installing Shinken

See the Documentation



python update

It will only update the shinken lib and scripts, but won't touch your current configuration


Shinken is installed with init.d scripts, enables them at boot time and starts them right after the install process ends. Based on your linux distro you only need to do:

chkconfig --add shinken chkconfig shinken on

or :

update-rc.d shinken defaults 20

Where is the configuration?

The configuration is on the directory, /etc/shinken.

Where are the logs?

Logs are in /var/log/shinken (what did you expect?)

I got a bug, how to launch the daemons in debug mode?

You only need to launch:

/etc/init.d/shinken -d start

Debug logs will be based on the log directory (/var/log/shinken)

I switched from Nagios, do I need to change my existing Nagios configuration?

No, there is no need to change the existing configuration - unless you want to add some new hosts and services. Once you are comfortable with Shinken you can start to use its unique and powerful features.

Learn more about how to use and configure Shinken

Jump to the Shinken documentation.

If you find a bug

Bugs are tracked in the issue list on GitHub . Always search for existing issues before filing a new one (use the search field at the top of the page). When filing a new bug, please remember to include:

  • A helpful title - use descriptive keywords in the title and body so others can find your bug (avoiding duplicates).
  • Steps to reproduce the problem, with actual vs. expected results
  • Shinken version (or if you're pulling directly from the Git repo, your current commit SHA - use git rev-parse HEAD)
  • OS version
  • If the problem happens with specific code, link to test files ( is a great place to upload code).
  • Screenshots are very helpful if you're seeing an error message or a UI display problem. (Just drag an image into the issue description field to include it).

Install Shinken as python lib

In avirtualenv

virtualenv env
source env/bin/activate
python install_lib
python -c 'from shinken.bin import VERSION; print(VERSION)'

Or directly on your system:

sudo python install_lib
python -c 'from shinken.bin import VERSION; print(VERSION)'

Get Shinken dev environment

To setup Shinken dev environment:

virtualenv env
source env/bin/activate
python develop
python install_data

If you want to use init scripts in your virtualenv you have to REsource activate:

source env/bin/activate


env/etc: Configuration folder

env/var/lib/shinken/modules: Modules folder

env/var/log/shinken: Logs folder

env/var/run/shinken: Pid files folder

Launch daemons

With binaries


shinken-arbiter -c env/etc/shinken/shinken.cfg


shinken-broker -c env/etc/shinken/daemons/brokerd.ini


shinken-scheduler -c env/etc/shinken/daemons/schedulerd.ini


shinken-poller -c env/etc/shinken/daemons/pollerd.ini


shinken-reactionner -c env/etc/shinken/daemons/reactionnerd.ini


shinken-receiver -c env/etc/shinken/daemons/receiverd.ini

With init scripts


env/etc/init.d/shinken-arbiter start


env/etc/init.d/shinken-broker start


env/etc/init.d/shinken-scheduler start


env/etc/init.d/shinken-poller start


env/etc/init.d/shinken-reactionner start


env/etc/init.d/shinken-receiver start
Something went wrong with that request. Please try again.