From 3e4d39f9468553dd28862aa1bd2667a2e0779a3c Mon Sep 17 00:00:00 2001
From: Kalle Struik <kalle@kallestruik.nl>
Date: Sun, 16 Feb 2025 13:14:26 +0100
Subject: [PATCH] Add docs for forgejo

---
 docs/roles/forgejo.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/roles/forgejo.md

diff --git a/docs/roles/forgejo.md b/docs/roles/forgejo.md
new file mode 100644
index 0000000..70f3a57
--- /dev/null
+++ b/docs/roles/forgejo.md
@@ -0,0 +1,13 @@
+# Forgejo role
+
+By default the forgejo server is installed without any users and without an
+external authentication provider. To create the first (admin) user ssh into the
+host and run 
+```bash
+forgejo-cli admin user create --username $username --email $email --admin
+```
+
+After this, you can log in with this new user and set up SSO through the
+[admin panel](https://$DOMAIN/admin/auths). After this is set up (and verified)
+you can change the initial user to use the new authentication source in the
+[admin panel](https://$DOMAIN/admin/users).