toutzn/nagios repository overview

⁠Docker-Nagios

Docker image for Nagios

Nagios Core running on Ubuntu 24.04 LTS with NagiosGraph & NRPE

⁠Configurations

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

⁠Install

docker pull toutzn/nagios:latest

⁠Running

Run with the example configuration with the following:

docker run --name nagios4 -p 0.0.0.0:8080:80 toutzn/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 toutzn/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.

⁠Docker Compose

Create a docker-compose.yml file:

services:
  nagios:
    image: toutzn/nagios:latest
    ports:
      - "8080:80"
    volumes:
      - nagiosetc:/opt/nagios/etc
      - nagiosvar:/opt/nagios/var
      - customplugins:/opt/Custom-Nagios-Plugins
      - nagiosgraphvar:/opt/nagiosgraph/var
      - nagiosgraphetc:/opt/nagiosgraph/etc
    environment:
      - NAGIOS_TIMEZONE=Europe/Berlin
      # - MAIL_RELAY_HOST=mail.example.com
      # - NAGIOS_FQDN=nagios.example.com

volumes:
  nagiosetc:
  nagiosvar:
  customplugins:
  nagiosgraphvar:
  nagiosgraphetc:

Then start with:

docker compose up -d

Nagios will be available at http://localhost:8080 with credentials nagiosadmin / nagios.

To upgrade to a newer image version without losing configuration:

docker compose pull
docker compose up -d

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 from JasonRivers [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 plugin 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⁠]