{"id":41931389,"url":"https://github.com/manios/docker-nagios","last_synced_at":"2026-01-25T17:39:30.794Z","repository":{"id":37890980,"uuid":"175055371","full_name":"manios/docker-nagios","owner":"manios","description":"Docker image for Nagios Core in Alpine Linux with basic plugins, available for x86, x64 , ARM v6, ARM v7 and ARM64.","archived":false,"fork":false,"pushed_at":"2025-11-28T13:05:59.000Z","size":96,"stargazers_count":71,"open_issues_count":12,"forks_count":26,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-11-29T09:52:31.631Z","etag":null,"topics":["alpine","alpine-linux","arm","arm64","armv6","armv7","docker","docker-image","docker-nagios","nagios","raspberry","raspberry-pi","x64"],"latest_commit_sha":null,"homepage":"https://www.nagios.org/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manios.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-03-11T17:57:17.000Z","updated_at":"2025-11-24T13:29:58.000Z","dependencies_parsed_at":"2023-11-19T11:26:33.938Z","dependency_job_id":"ef56a4b4-b194-454c-b515-a2c4e2b46f10","html_url":"https://github.com/manios/docker-nagios","commit_stats":null,"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/manios/docker-nagios","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manios%2Fdocker-nagios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manios%2Fdocker-nagios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manios%2Fdocker-nagios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manios%2Fdocker-nagios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manios","download_url":"https://codeload.github.com/manios/docker-nagios/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manios%2Fdocker-nagios/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28756149,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T16:32:25.380Z","status":"ssl_error","status_checked_at":"2026-01-25T16:32:09.189Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alpine","alpine-linux","arm","arm64","armv6","armv7","docker","docker-image","docker-nagios","nagios","raspberry","raspberry-pi","x64"],"created_at":"2026-01-25T17:39:30.112Z","updated_at":"2026-01-25T17:39:30.788Z","avatar_url":"https://github.com/manios.png","language":"Dockerfile","readme":"# Docker Nagios\n\nDocker image for [Nagios](https://www.nagios.org/), the Industry Standard in IT Infrastructure Monitoring. Nagios Core is running on [Alpine Linux](https://alpinelinux.org/), using [Apache HTTP](http://httpd.apache.org/) as a web server and [sSMTP](https://wiki.debian.org/sSMTP) as mail agent for email notifications.\n\nThe image is inspired by [JasonRivers/Docker-Nagios](https://github.com/JasonRivers/Docker-Nagios) image (Kudos to Jason!) but follows a different approach targetted to lightweight size and basic features.\n\nBuild Status: \n [![Nagios Build](https://github.com/manios/docker-nagios/actions/workflows/github-build.yml/badge.svg?branch=master)](https://github.com/manios/docker-nagios/actions/workflows/github-build.yml) [![Docker pulls badge](https://img.shields.io/docker/pulls/manios/nagios.svg)](https://hub.docker.com/r/manios/nagios)  [![Docker stars badge](https://img.shields.io/docker/stars/manios/nagios.svg)](https://hub.docker.com/r/manios/nagios) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/manios/docker-nagios/blob/master/LICENCE)\n\n* **Available architectures**: `x86`, `amd64`, `arm/v6`, `arm/v7`, `arm64`\n* **Where to file issues**: https://github.com/manios/docker-nagios/issues\n\n## Supported tags and respective `Dockerfile` links\n\n* `4.5.11`, `4.5`, `latest` [(4.5.11/Dockerfile)](https://github.com/manios/docker-nagios/blob/master/Dockerfile)\n\nFor more information about the image versions you may refer to the [CHANGELOG](https://github.com/manios/docker-nagios/blob/master/CHANGELOG.md)\n\n## Container registries\n\nSince `build-23` ([CHANGELOG](https://github.com/manios/docker-nagios/blob/build-23/CHANGELOG.md#build-23-2024-09-29)), the Nagios Docker image is available in Dockerhub and Github Container Registry (GHCR). You can pull it using one of the following ways:\n\n1. Dockerhub: `docker pull manios/nagios:latest`\n1. Github Container Registry: `docker pull ghcr.io/manios/nagios:latest`\n\n## Running\n\nRun with the example configuration with the following:\n\n```sh\ndocker run --name nagios -p 0.0.0.0:8080:80 manios/nagios:latest\n```\n\nalternatively you can use external Nagios configuration \u0026 log data with the following:\n\n```sh\ndocker run --name nagios  \\\n  -v /path-to-nagios/etc/:/opt/nagios/etc/ \\\n  -v /path-to-nagios/var:/opt/nagios/var/ \\\n  -v /path-to-nagios/ssmtp.conf:/etc/ssmtp/ssmtp.conf \\\n  -v /path-to-custom-plugins:/opt/Custom-Nagios-Plugins \\\n  -p 0.0.0.0:8080:80 \\\n  manios/nagios:latest\n```\n\nNotes: \n\n1. The container populates with default configuration files if the configuration directories are empty.\n1. The path for the custom plugins will be /opt/Custom-Nagios-Plugins, you will need to reference this directory in your configuration scripts.\n1. In order to receive mail notifications, you have to configure SSMTP. You can find example configuration inside the container in the file `/etc/ssmtp/ssmtp.conf` or in the repository in [overlay/etc/ssmtp/ssmtp.conf](https://github.com/manios/docker-nagios/blob/master/overlay/etc/ssmtp/ssmtp.conf).\n\nFor best results your Nagios container should have access to both IPv4 \u0026 IPv6 networks.\n\n### Credentials\n\nThe 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:\n\n```sh\ndocker run --name nagios  \\\n  -e NAGIOSADMIN_USER=\"godmode\" \\\n  -e NAGIOSADMIN_PASS=\"super-Duper-Secret!\" \\\n  -p 0.0.0.0:8080:80 \\\n  manios/nagios:latest\n```\n\n### Timezones\n\nBy default the Alpine container and Nagios both use `UTC`. In order to change the timezone we can pass the [tz timezone database name](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) as an environmental variable in `docker run` such as:\n\n```bash\ndocker run -e \"TZ=Europe/Athens\" manios/nagios:latest\n```\n\nThis will configure and use globally `\"Europe/Athens\"` in both container and Nagios process.\n\n### Init scripts\n\nSince tag `build-31` the docker image is able to run custom init scripts at the first time the container runs. This is useful if you want to install extra software and plugins, customise the container or execute any initialisation script of your choice.\n\nThis feature has the following characteristics in detail:\n\n* You can run one or more init scripts which have to be present in the `/container-entrypoint-init-scripts` container directory.\n* The custom init script(s) run to completion at the first container run. \n* Nagios process starts after all init scripts complete successfully.\n* If any init script throws an error, the container is restarted.\n* When all init scripts run to completion (exit code 0), a special file is written to the container filesystem, in the path `${NAGIOS_HOME}/container_first_run`. This file acts as a flag which verifies that the init scripts will be executed only on the first run.\n* If you want your init scripts to run in a specific order, then make sure to name them by using a numeric prefix such as:\n    1. `0001-install-mongodb.sh`\n    1. `0002-install-jq.sh`\n    1. `0003-configure-custom-plugins.sh`\n\nYou can also use a volume mount for your init scripts which can survive container deletions:\n\n```sh\ndocker run -d --name nagios \\\n    -p 8080:80 \\\n    -v \"$(pwd)/customscripts:/container-entrypoint-init-scripts\" \\\n    manios/nagios:latest\n```\n\nFor a detailed example you can have a look here: https://github.com/manios/docker-nagios/issues/96.\n\n## Flavours\n\nThis Docker image is designed with optimising resources usage in mind and is build for multiple hardware architectures. The following matrix can be used to determine if your hardware architecture is represented in a docker image tag:\n\n|Hardware|Image OS/Arch|\n|-|-|\n|PC (32bit)|linux/i386|\n|PC (64bit)|linux/amd64\n|Raspberry Pi 1|linux/arm/v6|\n|Raspberry Pi 2|linux/arm/v7|\n|Raspberry Pi 3|linux/arm/v7 or linux/arm64|\n|Raspberry Pi 4|linux/arm/v7 or linux/arm64|\n|Apple Silicon M1|linux/arm64|\n\n## Test configuration\n\nTo 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.\n\n```bash\ndocker exec -it mynagioscontainer bin/nagios -v etc/nagios.cfg\n```\n\n## Custom plugins\n\nThis image comes with the official [Nagios Plugins](https://github.com/nagios-plugins/nagios-plugins) preinstalled in order to remain lightweight in size. If you want to use custom plugins, you can install them in the `/opt/Custom-Nagios-Plugins` by using init scripts.\n\n## Troubleshooting\n\n### Nagios keeps restarting or shows a strange behaviour\n\nIn docker tag `build-5`, `build-6`, `build-7` we have used Alpine 3.14 as our base image. This comes with security updates which may cause trouble as described in [Release Notes forAlpine 3.14.0 \u003e faccessat2](https://wiki.alpinelinux.org/wiki/Release_Notes_for_Alpine_3.14.0#faccessat2).\n\nIn order to resolve this issue you should use docker tag `build-8` or you can follow the workarounds provided here: [#32 (comment)](https://github.com/manios/docker-nagios/issues/32#issuecomment-940355201).\n\n### My image does not run on Raspberry Pi\n\nAs already mentioned in [#17](https://github.com/manios/docker-nagios/issues/17), sometimes, because docker manifest related features are still experimental (after 2+ years of their introduction) it has happened when we tested in Raspberry Pi 1 (`arm-v6`) and Raspberry Pi 3 (`arm-v7`) that it does not download the `arm` image but the `amd64`.\n\nThus you can define explicitly which architecture to pull:\n\n```bash\ndocker pull --platform=linux/arm/v6 manios/nagios\n# or\ndocker pull --platform=linux/arm/v7 manios/nagios\n```\n\nand it works. Be advised that the `--platform` switch requires that you enable the [Docker Experimental Features](https://github.com/docker/cli/blob/master/experimental/README.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanios%2Fdocker-nagios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanios%2Fdocker-nagios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanios%2Fdocker-nagios/lists"}