/docker

LibreNMS Docker image based on Alpine Linux and Nginx

Primary LanguageDockerfileMIT LicenseMIT

Latest Version Build Status Docker Stars Docker Pulls
Become a sponsor Donate Paypal

About

LibreNMS Docker image based on Alpine Linux and Nginx.
If you are interested, check out my other Docker images!

💡 Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!

Demo

Try in PWD

Features

  • Run as non-root user
  • Multi-platform image
  • Dispatcher service as "sidecar" container
  • Syslog-ng support through a "sidecar" container
  • Built-in LibreNMS Weathermap plugin
  • Ability to add custom Monitoring plugins (Nagios)
  • Ability to add custom alert templates
  • OPCache enabled to store precompiled script bytecode in shared memory
  • s6-overlay as process supervisor
  • Traefik as reverse proxy and creation/renewal of Let's Encrypt certificates (see this template)
  • Memcached image ready to use for better scalability
  • RRDcached image ready to use for data caching and graphs
  • msmtpd SMTP relay image to send emails
  • MariaDB image as database instance

Build locally

git clone https://github.com/librenms/docker.git docker-librenms
cd docker-librenms

# Build image and output to docker (default)
docker buildx bake

# Build multi-platform image
docker buildx bake image-all

Multi-platform image

Following platforms for this image are available:

$ docker run --rm mplatform/mquery librenms/librenms:latest
Image: librenms/librenms:latest
 * Manifest List: Yes
 * Supported platforms:
   - linux/amd64
   - linux/arm/v6
   - linux/arm/v7
   - linux/arm64
   - linux/386
   - linux/ppc64le
   - linux/s390x

Documentation

How can I help?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to star 🌟 the project, or to raise issues 💬 You can also support this project by becoming a sponsor on GitHub 👏 or by making a Paypal donation to ensure this journey continues indefinitely! 🚀

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.