aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHimbeerserverDE <himbeerserverde@gmail.com>2023-11-26 16:12:39 +0100
committerHimbeerserverDE <himbeerserverde@gmail.com>2023-11-26 16:12:39 +0100
commit1291e68002cce2209b7bdb05431c7fe8eb4c85bc (patch)
tree82319dc48e544452d56c666af06b9ddb02eca8bf
parent1fa55f6aeac8d5c21492bf28eccbe49058875ce9 (diff)
document plugin auto building
-rw-r--r--doc/plugins.md14
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/plugins.md b/doc/plugins.md
index 6c386ce..1a8ab92 100644
--- a/doc/plugins.md
+++ b/doc/plugins.md
@@ -5,7 +5,19 @@ from being loaded. Plugins **cannot** be (re)loaded at runtime, you
need to restart the proxy.
## Installing plugins
-To install a plugin, clone the repository, cd into it and run:
+The recommended way to install plugins is cd'ing into the `plugins` directory,
+downloading the source code (e.g. using `git clone`) into it
+and starting the proxy without setting the `NoAutoPlugins` config option
+to `true`.
+
+The proxy will detect its own version automatically
+and attempt to build the plugin against it, making this the easiest way
+for end users to deal with versioning.
+
+This won't work in development builds.
+
+### Manual installation
+To install a plugin manually, clone the repository, cd into it and run:
```
go build -buildmode=plugin