From 9a7c64d9027632b18ce39f4f3e160e91a2375b82 Mon Sep 17 00:00:00 2001
From: alvis <allogn@gmail.com>
Date: Sat, 21 Mar 2026 11:25:12 +0000
Subject: [PATCH] Matrix: add user creation instructions

---
 Matrix.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/Matrix.md b/Matrix.md
index ad63e22..9207fdd 100644
--- a/Matrix.md
+++ b/Matrix.md
@@ -8,6 +8,31 @@ Homeserver: `mtx.alogins.net` (Caddy → Synapse container port 8008)
 
 Compose directory: `agap_git/matrix/`
 
+## Creating New Users
+
+Registration is disabled by default. Use `register_new_matrix_user` with the shared secret from `homeserver.yaml`.
+
+```bash
+docker exec -it matrix-synapse-1 register_new_matrix_user \
+  -u <username> \
+  -p <password> \
+  -c /data/homeserver.yaml \
+  http://localhost:8008
+```
+
+Add `--admin` flag to create an admin user. The shared secret is in `~/agap_git/matrix/data/synapse/homeserver.yaml` under `registration_shared_secret`.
+
+To create a user non-interactively:
+
+```bash
+docker exec matrix-synapse-1 register_new_matrix_user \
+  -u <username> \
+  -p <password> \
+  --no-admin \
+  -c /data/homeserver.yaml \
+  http://localhost:8008
+```
+
 ## Matrix Bot
 
 Repo: `~/matrixbot/` — `http://localhost:3000/alvis/matrixbot` (if pushed)