Setup

Linux

Download Nagstamon as .deb or .rpm and install its dependencies.

Start it in a terminal with nagstamon:

# nagstamon

You can choose a config directory manually with nagstamon configfile:

# nagstamon <your-custom-configdirectory>

Alternatively Nagstamon can be found in your Applications menu.

Windows

Download Nagstamon as .exe according to you binary platform (32 or 64 bit) and execute it. Everything should get at its place and you can start it from Start menu/Programs/Nagstamon. When run from command line you can pass a configfile like nagstamon.exe configfile in case you want to store it at another place than default:

c:\>"c:\Program Files\Nagstamon\nagstamon.exe" <your-custom-configdirectory>

Alternatively you can download the matching .zip which contains a complete standalone Nagstamon.

Mac OS

Since version 2.0 Nagstamon does not need any external package to run as it did before. Just download the .dmg disk image file and put the included Nagstamon app wherever you like – most probably the /Applications folder.

Other OS / Source

Download Nagstamon as .tar.gz, extract the archive, resolve its dependencies and install Nagstamon into your local python installation with python setup.py install:

# python setup.py install

The start script mostly is /usr/local/bin/nagstamon.py.

First steps

At the first start of Nagstamon a dialog window appears where you have to configure at least one monitor server to check.

Configure your monitor server installation:

  • the monitor server type,
  • the URL of your monitor main page,
  • only on Nagios, older Icinga and Thruk: the URL to your monitor CGI – without any status.cgi etc.
  • the username
  • the password
  • a proxy if necessary

If you want to store the password in your system’s keystore/keyring/vault you can enable it at the first tab of the settings dialog.

The config directory as default is in $HOME/.nagstamon.