jasonrivers/nagios repository overview

⁠Docker-Nagios

Docker image for Nagios

Build Status:

Nagios Core 4.5.2 running on Ubuntu 22.04 LTS with NagiosGraph & NRPE

⁠Configurations

Nagios Configuration lives in /opt/nagios/etc NagiosGraph configuration lives in /opt/nagiosgraph/etc

⁠Install

docker pull jasonrivers/nagios:latest

⁠Running

Run with the example configuration with the following:

docker run --name nagios4 -p 0.0.0.0:8080:80 jasonrivers/nagios:latest

alternatively you can use external Nagios configuration & log data with the following:

docker run --name nagios4  \
  -v /path-to-nagios/etc/:/opt/nagios/etc/ \
  -v /path-to-nagios/var:/opt/nagios/var/ \
  -v /path-to-custom-plugins:/opt/Custom-Nagios-Plugins \
  -v /path-to-nagiosgraph-var:/opt/nagiosgraph/var \
  -v /path-to-nagiosgraph-etc:/opt/nagiosgraph/etc \
  -p 0.0.0.0:8080:80 jasonrivers/nagios:latest

Note: The path for the custom plugins will be /opt/Custom-Nagios-Plugins, you will need to reference this directory in your configuration scripts.

There are a number of environment variables that you can use to adjust the behaviour of the container:

For best results your Nagios image should have access to both IPv4 & IPv6 networks

⁠Credentials

The default credentials for the web interface is nagiosadmin / nagios

⁠Extra Plugins

• Nagios nrpe [http://exchange.nagios.org/directory/Addons/Monitoring-Agents/NRPE--2D-Nagios-Remote-Plugin-Executor/details⁠]
• Nagiosgraph [http://exchange.nagios.org/directory/Addons/Graphing-and-Trending/nagiosgraph/details⁠]
• JR-Nagios-Plugins - custom plugins I've created [https://github.com/JasonRivers/nagios-plugins⁠]
• WL-Nagios-Plugins - custom plugins from William Leibzon [https://github.com/willixix/WL-NagiosPlugins⁠]
• JE-Nagios-Plugins - custom plugins from Justin Ellison [https://github.com/justintime/nagios-plugins⁠]
• DF-Nagios-Plugins - custom pluging for MSSQL monitoring from Dan Fruehauf [https://github.com/danfruehauf/nagios-plugins⁠]
• check-mqtt - custom plugin for mqtt monitoring from Jan-Piet Mens [https://github.com/jpmens/check-mqtt.git⁠]