From: Vincent Bernat <vincent@bernat.ch>
Date: Mon, 21 Jun 2021 22:48:17 +0000 (+0200)
Subject: installation: document Docker
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=beebba5b08eb49f28896044bdb05ff362ff8e7ca;p=thirdparty%2Flldpd.git

installation: document Docker
---

diff --git a/content/installation.html b/content/installation.html
index 144c4ec3..8e8a1451 100644
--- 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].