Add help for creating a user via docker (#7885)

matrix-org · Jul 17, 2020 · 1ec2961 · 1ec2961
1 parent a5545cf
commit 1ec2961
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 0 deletions.
diff --git a/changelog.d/7885.doc b/changelog.d/7885.doc
@@ -0,0 +1 @@
+Provide instructions on using `register_new_matrix_user` via docker.
diff --git a/docker/README.md b/docker/README.md
@@ -94,6 +94,21 @@ The following environment variables are supported in run mode:
 * `UID`, `GID`: the user and group id to run Synapse as. Defaults to `991`, `991`.
 * `TZ`: the [timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) the container will run with. Defaults to `UTC`.
 
+## Generating an (admin) user
+
+After synapse is running, you may wish to create a user via `register_new_matrix_user`.
+
+This requires a `registration_shared_secret` to be set in your config file. Synapse
+must be restarted to pick up this change.
+
+You can then call the script:
+
+```
+docker exec -it synapse register_new_matrix_user http://localhost:8008 -c /data/homeserver.yaml --help
+```
+
+Remember to remove the `registration_shared_secret` and restart if you no-longer need it.
+
 ## TLS support
 
 The default configuration exposes a single HTTP port: http://localhost:8008. It
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Provide instructions on using `register_new_matrix_user` via docker.