summary refs log tree commit diff
diff options
context:
space:
mode:
-rw-r--r--changelog.d/14892.doc1
-rw-r--r--docs/workers.md11
2 files changed, 12 insertions, 0 deletions
diff --git a/changelog.d/14892.doc b/changelog.d/14892.doc
new file mode 100644
index 0000000000..2bc3ad06c6
--- /dev/null
+++ b/changelog.d/14892.doc
@@ -0,0 +1 @@
+Document how to start Synapse with Poetry. Contributed by @thezaidbintariq.
diff --git a/docs/workers.md b/docs/workers.md
index bc66f0e1bc..2eb970ffa6 100644
--- a/docs/workers.md
+++ b/docs/workers.md
@@ -160,7 +160,18 @@ recommend the use of `systemd` where available: for information on setting up
 [Systemd with Workers](systemd-with-workers/). To use `synctl`, see
 [Using synctl with Workers](synctl_workers.md).
 
+## Start Synapse with Poetry
 
+The following applies to Synapse installations that have been installed from source using `poetry`.
+
+You can start the main Synapse process with Poetry by running the following command:
+```console
+poetry run synapse_homeserver -c [your homeserver.yaml]
+```
+For worker setups, you can run the following command
+```console
+poetry run synapse_worker -c [your worker.yaml]
+```
 ## Available worker applications
 
 ### `synapse.app.generic_worker`