silvertoken/docker-nagios repository overview

⁠Docker Nagios

Docker image for Nagios⁠, the Industry Standard In IT Infrastructure Monitoring. Nagios Core is running on Alpine Linux⁠, using Apache HTTP⁠ as a web server and sSMTP⁠ as mail agent for email notifications.

The image is inspired by JasonRivers/Docker-Nagios⁠ image (Kudos to Jason!) but follows a different approach targetted to lightweight size and basic features.

Build Status:

⁠Quick reference

• Supported architectures: amd64, arm32v6, arm32v7
• Where to file issues: https://github.com/manios/docker-nagios/issues⁠

⁠Supported tags and respective Dockerfile links

• 4.4.5, 4.4, latest (4.4.5/Dockerfile)⁠

⁠Running

Run with the example configuration with the following:

docker run --name nagios4 -p 0.0.0.0:8080:80 manios/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-nagios/ssmtp.conf:/etc/ssmtp/ssmtp.conf \
  -v /path-to-custom-plugins:/opt/Custom-Nagios-Plugins \
  -p 0.0.0.0:8080:80 \
  manios/nagios:latest

Notes:

1. The container populates with default configuration files if the configuration directories are empty.
2. The path for the custom plugins will be /opt/Custom-Nagios-Plugins, you will need to reference this directory in your configuration scripts.
3. In order to receive mail notifications, you have to configure SSMTP. You can find example configuration in docker-nagios.

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

⁠Credentials

The default credentials for the web interface is nagiosadmin / nagios. However you can define your own credentials by overriding NAGIOSADMIN_USER and NAGIOSADMIN_PASS when you run the container. For example:

docker run --name nagios  \
  -e NAGIOSADMIN_USER="godmode" \
  -e NAGIOSADMIN_PASS="super-Duper-Secret!" \
  -p 0.0.0.0:8080:80 \
  manios/nagios:latest

⁠Flavours

This Docker image is designed with optimising resources usage in mind and is build for 3 architectures.

⁠Test configuration

To check if your Nagios configuration is OK, you can run the following while your container is running. We assume that you use /opt/nagios/etc/nagios.cfg as your main configuration file.

docker exec -it mynagioscontainer bin/nagios -v etc/nagios.cfg