tronyx/nagios repository overview

⁠Docker-Nagios

⁠Notes

Fork of JasonRivers Docker Nagios image⁠ to incorporate various improvements from the open PRs on his repo along with other updates and quality of life improvements.

⁠Incorporated PRs

Listing these as I wish to give the original users credit for their work.

• #96⁠ - Fix issue with Nagiosgraph source (fregge⁠)
• #101⁠ - Fixes to allow building on ARM aarch64 architecture (garethrandall⁠)
• #110⁠ - Update to Ubuntu 18.04 LTS (asimzeeshan⁠)
• #112⁠ - Add python3-nagiosplugin for plugins that need it (davralin⁠)
• #116⁠ - Update Nagios to 4.4.6 (mmerian⁠)
• #120⁠ - Add NSCA (mmerian⁠)
• #130⁠ - Add Perl encryption libraries (rehashedsalt⁠)
• #132⁠ - Add rSync (LutzLegu⁠)
• #165⁠ - Added libcrypt-x509-per and libtext-glob-perl modules (Scott-Jones-COS⁠)

⁠Changes That I've Made

Things that I have changed/updated/added to date:

• Updated the image to Ubuntu 26.04 LTS
• Updated Nagios Core to the current latest
• Updated Nagios Plugins to current latest
• Updated NRPE to current latest
• Updated NCPA to current latest
• Updated NSCA to current latest
• Added NagiosTV
• Built multi-arch images (amd64 & arm64)
• Implemented multi-stage build to reduce the final image size by nearly 50%

⁠Information

Nagios Core running on Ubuntu 26.04 LTS with NagiosGraph, NRPE, NCPA, NSCA, and NagiosTV.

The images can be found on the Docker Hub Registry⁠ or the GitHub Registry⁠.

⁠Configurations

• Nagios configuration is stored in the /opt/nagios/etc directory.
• NagiosGraph configuration is stored in the /opt/nagiosgraph/etc directory.
• NSCA configuration is stored in the /opt/nagios/etc directory.

⁠Pull the Image

docker pull tronyx/nagios
docker pull ghcr.io/tronyx/nagios

⁠Versions/Docker Tags

I may spawn other branches for testing from time to time, IE: new Ubuntu LTS or something similar, but for the most part these are the main branches.

⁠Running

Run the container with the example configuration using the following docker commands:

docker run --name nagios -p 8080:80 tronyx/nagios
docker run --name nagios -p 8080:80 ghcr.io/tronyx/nagios

Alternatively you can use external Nagios configuration & log data with the following docker commands:

docker run --name nagios  \
  -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 8080:80 tronyx/nagios

docker run --name nagios  \
  -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 8080:80 ghcr.io/tronyx/nagios

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

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

For the best results your Nagios container should have access to both IPv4 & IPv6 networks.

⁠Credentials

The default credentials for the web interface are:

NAGIOSADMIN_USER/NAGIOSADMIN_PASS only seed /opt/nagios/etc/htpasswd.users the first time the container starts (i.e. when that file doesn't already exist, such as on a fresh named volume). Changing these env vars on a container that already has a populated etc volume has no effect on the stored password.

To change the password on an existing container:

docker exec -it nagios htpasswd -b /opt/nagios/etc/htpasswd.users nagiosadmin '<new-password>'

⁠Health Check

The image defines a Docker HEALTHCHECK that reports unhealthy unless both of the following succeed:

• Apache answers an HTTP request on http://localhost/ — any response counts, including a 401/403, since the check only cares that Apache itself is up and processing requests.
• runit reports the nagios service as up (sv check /etc/service/nagios).

⁠Extra Plugins