librenms-docker

mirror of https://github.com/librenms/docker.git synced 2026-01-23 18:25:09 +00:00

No description

alpine-linux docker librenms nagios-plugins nginx snmpd syslog-ng

Find a file

CrazyMax 2c4abe5f34 ci: test workflow (#284 ) Co-authored-by: CrazyMax <crazy-max@users.noreply.github.com>		2022-07-13 03:14:34 +02:00
.github	ci: test workflow (#284 )	2022-07-13 03:14:34 +02:00
doc	Add MAX_INPUT_VARS env var (#271 )	2022-07-13 02:01:51 +02:00
examples	Add MAX_INPUT_VARS env var (#271 )	2022-07-13 02:01:51 +02:00
rootfs	Ensure scripts exit early on error and set shellcheck (#283 )	2022-07-13 03:02:55 +02:00
test	ci: test workflow (#284 )	2022-07-13 03:14:34 +02:00
.dockerignore	Update README	2020-11-01 20:52:34 +01:00
.editorconfig	Rename to rootfs	2019-11-19 14:10:17 +01:00
.gitattributes	Rename to rootfs	2019-11-19 14:10:17 +01:00
.gitignore	Run as non-root user (#6 )	2019-11-19 14:09:34 +01:00
CHANGELOG.md	Update CHANGELOG	2022-06-17 15:39:42 +02:00
docker-bake.hcl	LibreNMS 21.6.0 (#210 )	2021-06-28 00:31:11 +02:00
Dockerfile	Reduce image size by about 200MB	2022-07-09 02:04:54 -05:00
LICENSE	Update LICENSE	2022-01-26 14:38:37 +01:00
README.md	Removing references to Nagios because of confiusion (#237 )	2021-10-21 19:16:11 +02:00

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 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

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.