General

What is Thruk?

Thruk is a Webgui for Nagios (and compatible) based on the Livestatus
API. It’s capable of merging multiple cores into a single display
while being much faster than the original cgis. In addition there have
been tons of usability improvments and there are plenty of useful
addons included like a dashboard, business process addons, a
configuration interface and many more…​

Is Thruk an Abbreviation? What does Thruk mean?

Thruk is just a random word and has no meaning. Pronounce it like Truck.

Where is the statusmap?

The statusmap got replaced by a own variant which is more scalable in
large environments. Its shipped as Thruk addon, but enabled by
default. See the plugins page for details and screenshots.

Authorization/Authentication is not working

Authentication is done by the webserver, so authentication is only available
with the fastcgi version.

All dates and times are displayed with the wrong timezone

Try to set the use_timezone configuration option in your
thruk_local.conf

Usage

How do I select hosts/services on the status page?

Just click on the empty table row when the row is highlighted. This only works
if you do not click on a link.

The default view can be exported from the Settings menu inside the panorama
dashboard.

How can I set custom page titles

There are few ways to do this. The first way is you can turn on the
use_bookmark_titles in your thruk_local.conf:

use_bookmark_titles = 1

Now anytime you go to one of your Thruk bookmarks the name of
that bookmark will be used as the page title.
The second option is on most pages adding title=your title here to
the url will set a custom title

How can I enable form based authentication

activated by default since v2.0

In order to use the form or cookie based authentication like demo.thruk.org does,
you have to do two small changes in your apache configuration.
Get thruk_cookie_auth.example
and put everything except the RewriteLock into the virtualhost of your choice.
The RewriteLock must be outside any virtualhost. After that, restart the apache.

How can I disable cookie authentication

In OMD you just need to run omd config set THRUK_COOKIE_AUTH off

Starting with v2.0 cookie (form based) authentication is enabled by default. In
case you want to disable it again and switch back to standard basic
authentication, you just need to comment the includes in your apache
configuration.

How can I setup multiple sites with OMD

Installation

Is it possible to operate Thruk in a cluster?

Yes, just put a load balancer before 2 (or more) Thruk installations
and make sure the var_path directory is shared between all instances ( by
NFS, DRBD or similar ). There is usually not much traffic in this
folder.

wkhtmltopdf

wkhtmltopdf is no longer required and has been replaced by phantomjs.

phantomjs

phantomjs is required to create PDF reports with the reports2 plugin. You can get
phantomjs from http://phantomjs.org/ if it’s not available for your system.

How can I enable the business process addon.

It works out of the box with OMD. If not using OMD, some manual steps
are required which are described in the
official documenation.

and you use socat for livestatus over ssl, please change to stunnel or
ssh with the normal xinetd solution.

undefined symbol: Perl_Istack_sp_ptr

You will get perl errors about undefined symbols when you try to
install a debian package on ubuntu or a ubuntu 11 deb file on ubuntu
12 or any package on a different platform than the package was build
for.

The solution is simple: use the right package for your distribution.
If there is no package is available for your platform, use the source
installation.

Premature end of script headers: fcgid_env.sh

A few things to check:

check the apache error log for more details.

check the thruk logfile, usually located in /var/log/thruk/error.log

if you are using Redhat/Centos, check if you have SELinux enabled:

#>getenforce
Disabled

Enforcing means SELinux is enable. Details can be found in the audit
log: /var/log/audit/audit.log. SELinux can be disabled in
/etc/selinux/config (you will have to reboot once to make the
changes active).

If there is no error in either apache or thruk logs, try to manually run the
fcgi script with your webserver user (usually something like www-data or
apache)

+
su - www-data -c "/usr/share/thruk/fcgid_env.sh"
STDIN is not a socket: specify a listen location at /usr/lib/thruk/perl5/Plack/Handler/FCGI.pm line 57.

+

If you see the error above, eveything is ok. Otherwise you should see the real
error now.

possible csrf, no or invalid token

This happens if you directly send commands to Thruk without a valid
csrf protection token. This will happen in combination with nagstamon.
You have to put those clients in the exception list:
csrf_allowed_hosts.