How to install bleeding-edge Shinken in a minute with OMD

You probably have noticed that development of the new Nagios-compatible monitoring system Shinken progresses very fast. Every few hours there is another commit at GitHub, where Shinken’s code repository is hosted. Now if you want to try all these new features immediately, there’s a very easy method which requires a simple update-command instead of a fresh install.

First of all you need an installation of the Open Monitoring Distribution OMD, the single-package monitoring ecosystem. Get the apropriate package for your Linux distro from our repository. You have to install OMD only once (…to start with this howto. Of course there are 3 or 4 updates per year for OMD too)</br>
When you are done, create a site.

# omd create shishi
# omd config shishi set CORE shinken

Now you have a working monitoring system with a Shinken core. However, it is not the current development version from GitHub. It’s the Shinken version from the time when OMD was packaged.
So you have to make a local copy of the code repository on your test machine.

# cd /tmp
# git clone

After you downloaded the up-to-date Shinken files you need to overwrite the old files (owned by OMD) with the ones in the git repository. This is simply done with a bind-mount.

# mount --bind \
    /tmp/shinken/shinken \

Now you can start the site and play around with the most current Shinken code. (And get a visual impression by pointing your browser to http://<your test server>/shishi/thruk or http://<your test server>/shishi/shinken)

# omd start shishi

As i wrote in the beginning, there are constantly updates to the repository at GitHub. Keeping an eye on the development and always running the newest code requires not more than updating your local repository and restart the site.

# omd stop shishi
# cd /tmp/shinken
# git pull
# omd start shishi

Have fun with Shinken.

Author: Gerhard Laußer
Categories: nagios, omd, shinken
Monitoring-Workshop 2017 12./13.9. Düsseldorf