hieutdo / docker

LibreNMS Docker image based on Alpine Linux and Nginx

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

Features

• Run as non-root user
• Multi-platform image
• Dispatcher service as "sidecar" container
• Syslog-ng support through a "sidecar" container
• Snmp-trap support through a "sidecar" container
• Built-in LibreNMS Weathermap plugin
• Ability to add custom Monitoring plugins
• 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

• Docker
  • Environment variables
  • Volumes
  • Ports
• Usage
• Notes
  • Edit configuration
  • LNMS command
  • Validate
  • Dispatcher service
  • Add a LibreNMS plugin
  • Syslog-ng
  • Additional Monitoring plugins
  • Custom alert templates
• Upgrade

Contributing

Want to contribute? Awesome! 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.