mewsse/observium repository overview

⁠docker-observium

Unofficial Docker image for Observium Community Edition⁠. Not affiliated with or endorsed by Observium Limited.

The image is rebuilt automatically every week, so it picks up new CE releases and base image security updates without manual work. Built for linux/amd64 and linux/arm64 (Raspberry Pi 4/5 and other 64-bit ARM boards work fine).

Published as ghcr.io/mews-se/observium (primary) and mirrored to Docker Hub as mewsse/observium — same builds, same tags.

⁠Quick start

git clone https://github.com/mews-se/docker-observium.git
cd docker-observium
cp .env.example .env   # edit at least DB_PASS
docker compose up -d

Then open http://<host>:8080 and log in with the admin credentials from your .env.

The stack runs three containers: web (Apache + PHP), poller (cron with the standard Observium discovery/poller/housekeeping schedule) and db (MariaDB). Database schema is created and upgraded automatically on start, and the first admin user is created if the user table is empty.

⁠Environment variables

⁠Tags

⁠Adding devices

Use the web UI, or the CLI:

docker compose exec web su -s /bin/bash www-data -c './add_device.php <hostname> <community>'

⁠Updating

docker compose pull
docker compose up -d

Schema upgrades run automatically on container start.

⁠Building locally

docker compose build web

The Dockerfile downloads the latest CE tarball at build time; pass --build-arg OBSERVIUM_REFRESH=$(date +%s) to force a fresh download.

⁠License

The files in this repository are MIT licensed. Observium itself is not included in the repository; the Docker image downloads the unmodified Observium Community Edition tarball from observium.org at build time. Observium CE is distributed under its own license (a simplified QPL) — see observium.org⁠ for details. Observium is a trademark of Observium Limited.