From 11a33bd6af96e3d258f55cb193ba2aefdeb1834a Mon Sep 17 00:00:00 2001
From: Hans van Zijst <hans@procolix.com>
Date: Wed, 13 Nov 2024 14:56:10 +0100
Subject: [PATCH] Documented how to create an admin user in Synapse.

---
 matrix/synapse/README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/matrix/synapse/README.md b/matrix/synapse/README.md
index a0835d6e..5ba92206 100644
--- a/matrix/synapse/README.md
+++ b/matrix/synapse/README.md
@@ -112,6 +112,30 @@ After changing the database, restart Synapse and check whether it can connect
 and create the tables it needs.
 
 
+# Create admin
+
+Synapse doesn't create an admin account at install time, so you'll have to do
+that yourself.
+
+You need to set a `registration_shared_secret` for this, set that in
+`conf.d/keys.yaml` like this:
+
+```
+registration_shared_secret: xxxx
+```
+
+You can create such a key by running `pwgen -csn 52 1`. Restart Synapse after
+setting this key.
+
+Now create an admin user. Login and issue this command:
+
+```
+register_new_matrix_user -u admin -a -c /etc/matrix-synapse/conf.d/keys.yaml
+```
+
+This will ask for a password, choose a safe one.
+
+
 # Logging
 
 Logging is configured in `log.yaml`. Some logging should go to systemd, the