summary refs log tree commit diff
path: root/docker/README.md
diff options
context:
space:
mode:
authorRichard van der Hoff <1389908+richvdh@users.noreply.github.com>2019-06-27 13:52:40 +0100
committerGitHub <noreply@github.com>2019-06-27 13:52:40 +0100
commit555b6fa0d534ac897b139ee1e57a651e50e1aec5 (patch)
tree98e91e8abce6f76b739a3f07095e7b3efe714de5 /docker/README.md
parentDocker image: open the non-TLS port by default. (#5568) (diff)
downloadsynapse-555b6fa0d534ac897b139ee1e57a651e50e1aec5.tar.xz
Docker image: Add a migrate_config mode (#5567)
... to help people escape env var hell
Diffstat (limited to 'docker/README.md')
-rw-r--r--docker/README.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docker/README.md b/docker/README.md
index 7f7d27ed33..b62417c281 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -112,3 +112,19 @@ For backwards-compatibility only, the docker image supports creating a dynamic
 configuration file based on environment variables. This is now deprecated, but
 is enabled when the `SYNAPSE_SERVER_NAME` variable is set (and `generate` is
 not given).
+
+To migrate from a dynamic configuration file to a static one, run the docker
+container once with the environment variables set, and `migrate_config`
+commandline option. For example:
+
+```
+docker run -it --rm \
+    --mount type=volume,src=synapse-data,dst=/data \
+    -e SYNAPSE_SERVER_NAME=my.matrix.host \
+    -e SYNAPSE_REPORT_STATS=yes \
+    matrixdotorg/synapse:latest migrate_config
+```
+
+This will generate the same configuration file as the legacy mode used, but
+will store it in `/data/homeserver.yaml` instead of a temporary location. You
+can then use it as shown above at [Running synapse](#running-synapse).