librenms-docker/README.md

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 or legacy cron as "sidecar" containers
• Syslog-ng support through a "sidecar" container
• Ability to configure distributed polling
• Built-in LibreNMS Weathermap plugin
• Ability to add custom Monitoring plugins (Nagios)
• 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

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

Documentation

• Docker
  • Environment variables
  • Volumes
  • Ports
• Usage
• Notes
  • Edit configuration
  • LNMS command
  • Validate
  • Dispatcher service
  • Cron (legacy)
  • Syslog-ng
  • Additional Monitoring plugins (Nagios)
• Upgrade

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.