Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build status


okconfig a robust template mechanism for Nagios configuration files. Providing standardized set of configuration templates and select quality plugins to enterprise quality monitoring.

Getting Started

Standard http checks on

okconfig addhost --host --template http

Also check ssl connection and ssl certificate:

okconfig addtemplate --host --template https

Create a new host and give them standard linux checks. Then install nrpe on it:

okconfig addhost --host --address --template linux
okconfig install --host --ssh --user root --password my_password

Add mssql service checks to an existing host:

okconfig addtemplate --host --template mssql

Supported Platforms for nagios server

The developers work hard to make sure templates, packages and plugins and service checks work and don't break when okconfig is upgraded.

With over 60 plugins and 380 service templates there are limits to how many platforms we can support. Currently we support running the nagios server on:

  • RHEL 7.x / 8.x
  • Centos 7.x / 8.x

If anyone is willing to provide decent quality packages for debian or other distros we are happy to build and host them.

Installing on rhel/centos

rpm -Uvh$HOSTTYPE/epel-release-6-8.noarch.rpm
rpm -Uhv
yum-config-manager --enable ok-testing

yum install okconfig
okconfig verify


At the very least okconfig needs the following:

  • python-3.6
  • pynag
  • python-paramiko (for deploying remote agents via ssh)
  • winexe (for deploying remote agents to windows servers)

Installing from source

If you want to play with the source or try it out on an unsupported platform. These instructions should get you started:

cd /opt
git clone
echo 'export PYTHONPATH=$PYTHONPATH:/opt/okconfig' > /etc/profile.d/
cp /opt/okconfig/etc/okconfig.conf /etc/okconfig.conf
source /etc/profile

ln -s /opt/okconfig/usr/share/okconfig /usr/share/
ln -s /opt/okconfig/usr/bin/okconfig /usr/local/bin/

# Remember to edit /etc/okconfig.conf and verify all paths apply to your system
# Configure Nagios.cfg
okconfig init

# Test
okconfig verify

Contact us