From 85523da7563866fb4561cd101f115e3110c4d73a Mon Sep 17 00:00:00 2001
From: Jellyfrog <Jellyfrog@users.noreply.github.com>
Date: Tue, 15 Sep 2026 12:44:05 +0200
Subject: [PATCH] Document how to add plugins that persists between restarts

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index a3162ee9..12c8145a 100644
--- a/README.md
+++ b/README.md
@@ -404,6 +404,22 @@ will be removed and yours will be used.
 > [!WARNING]
 > Container has to be restarted to propagate changes.
 
+### Add a LibreNMS plugin package
+
+To add a [plugin package](https://docs.librenms.org/Extensions/Plugin-System/#plugin-package),
+build your own image on top of the official image:
+
+```dockerfile
+FROM librenms/librenms:latest
+RUN gosu librenms ./lnms plugin:add socialiteproviders/saml2
+```
+
+```console
+$ docker build -t librenms-with-plugins .
+```
+
+Use this image instead of `librenms/librenms` in your `compose.yml`.
+
 ### Additional Monitoring plugins
 
 You can add a custom Monitoring plugin in `/data/monitoring-plugins/`.