CoffeeSaint is a fully customizable Nagios status viewer. It grabs the status from a Nagios server and displays it in a fullscreen GUI.
It is written in Java so it should run on all platforms (tested on Linux, AIX 6.1 and windows xp) capable of running Java 5. For compiling with GCJ you need at least version 4.4.5 of GCJ. It also runs fine with OpenJDK version 1.6.0 (and probably later).
CoffeeSaint is compatible with Nagios version 1, 2, 3 and xi. It also works fine with Groundwork.

Main features

  • Can display an image on the background (this can be an URL so you can display webcam images as well)
  • Remotely configurable via built-in webserver
  • Handles all Nagios versions
  • Can retrieve remotely Nagios statuses (several methods)
  • Can play a sound if the status goes to error
  • Written in Java so should run on all systems (linux, microsoft windows, apple mac)
  • Font/font size/background color/number of rows displayed are configurable
  • Uses "least squares estimate" to predict error count
  • Can show the status of multiple Nagios servers in one screen
  • Sort-order fully configurable
  • Can run in fullscreen mode - can also span multiple screens
  • Can prioritize configurable hosts/services (using regular expression patterns)
  • Can filter hosts/services
  • Sparklines with performance data (plugin data as gathered by Nagios) and latency data
  • Can run standalone as well as a webbrowser applet
CoffeeSaint has been tested with a setup of 800 hosts and 5600 services.


CoffeeSaint-4.8.jar - can now set a minimum height per row so that if more than '--nrows' problems are to be displayed, the height of the rows is adjusted
CoffeeSaint-4.7.jar - fixed a couple of bugs: command-line version did not work and escapes had problems

The source code of coffeesaint can be obtained from GitHub.

Example configuration file: bruin.conf. Use with: java -jar CoffeeSaint.jar --config bruin.conf
You need to add your own Nagios server either via the web-interface, via the commandline or by editting this file.

Nagios: building enterprise-grade monitoring infrastructures for systems and networks (2nd edition)


The manual can be downloaded here.
It is a PDF file.


In short: the jar-file is released under GPLv2.
CoffeeSaint is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 2.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.


Click on a picture to enlarge it
This picture shows CoffeeSaint displaying a couple of problems with a webcam behind them.

The following picture is CoffeeSaint displaying 9 webcams in one view.

As you may have noticed in the two images above: the header-line (with the counter, the time, the totals) looks different on these two screendumps. That is to show that this line is fully configurable to your needs.
The following image shows a regular error view with the duration added to each problem.

With transparency (version 2.1 and later). Of course, the amount of transparency (if you want it at all) is configurable.

With fixed width host-field.

With a (user selectable) logo in the upper-right corner and a backgroundcolor fade-effect.

This screenshot has on the bottom the output of an external script (using a temperature-sensor made by Cleware) which determines the temperature (using the --footer switch / footer configurationfile parameter.

Screenshot showing the remote-configuration-web-interface with Nagios performancedata with sparklines.

Screenshot showing the configuration-menu of the web-interface.

With lines between each row and multiple columns (for really large screens: version 1.9).

With font styles:

With sparklines (version 2.3 and later) - sparklines are small inline graphs. In the case of CoffeeSaint they display the performance data collected by Nagios.

Webbrowser applet demo

This is a demo of running CoffeeSaint in your webbrowser. Tested with chrome/firefox/internet explorer/safari/opera on linux/windows/macos.
click here

Webserver demo

This is a demo of the configuration-webserver.
click here


  • when invoking CoffeeSaint from a startup-folder on windows with multiple screens attached, you might need to add a sleep statement before CoffeeSaint as in some cases windows starts the program before the second screen is fully initialized; this causes the screen to be blank

Running CoffeeSaint as a webbrowser applet

How to do that is described here.


Send in your photographs!

Got CoffeeSaint running in your sysadmins room? Send in a picture! I'll add a link underneath it to your website.

UMC Utrecht (DBG)



YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.

Last updated: 2013/07/08