installation: document Docker

[thirdparty/lldpd.git] / content / installation.html

diff --git a/content/installation.html b/content/installation.html
index 144c4ec30cdf6e832ba612e0fb74d11ae4ddee94..8e8a1451a650c797daaa031e28d3a8971e6ef3b9 100644 (file)
--- a/content/installation.html
+++ b/content/installation.html
@@ -74,6 +74,28 @@ available directly with the following command:
 
 It is also possible to [build _lldpd_ from source][].
 
+## Docker
+
+You can use Docker to run `lldpd`:
+
+    docker run --rm --net=host --uts=host \
+               -v /etc/os-release:/etc/os-release \
+               --cap-add=NET_RAW --cap-add=NET_ADMIN \
+               --name lldpd \
+               ghcr.io/lldpd/lldpd:latest
+
+In place of `latest` which provides you with the latest stable
+version, you may use `1`, `1.0`, `{{ resource.meta.latestversion }}`
+to match specific versions.
+
+To execute `lldpcli`, use:
+
+    docker exec lldpd lldpcli show neighbors
+
+Or to get the command-line:
+
+    docker exec -it lldpd lldpcli
+
 # BSD
 
 `lldpd` is currently available in the ports tree of most BSDs[^ports].