diff --git a/matrix/synapse/workers.md b/matrix/synapse/workers.md
index cf7c4f1c..ee8adbe8 100644
--- a/matrix/synapse/workers.md
+++ b/matrix/synapse/workers.md
@@ -225,3 +225,21 @@ worker_listeners:
         compress: false
 ```
 
+### Mediaworker
+
+To make sure the worker takes care of handling media, and not the main
+process, we have to add `enable_media_repo: False` to the configuration file.
+Then you create the worker, like this:
+
+```
+worker_app: "synapse.app.media_repository"
+worker_name: "mediaworker1"
+worker_log_config: "/data/log.config/media.log.config"
+
+worker_listeners:
+  - path: "/run/matrix-synapse/inbound_mediaworker1.sock"
+    type: http
+    x_forwarded: true
+    resources:
+      - names: [media]
+```