Add docs for initial admin user setup #20

Merged
mac-chaffee merged 3 commits from docs-n-deprecations into master 2025-06-24 12:28:53 +00:00
Owner

When first deploying keycloak, I was a little unsure about how to set up the real admin user. Surprisingly, the keycloak docs don't tell you how to do this, this is really all they say:

So I wrote the directions here. Also added a section on recovery, because I messed up when creating my initial admin user and lost its password 🤦‍♂️

Also fixed some deprecated traefik labels as described in coop-cloud/example#3

When first deploying keycloak, I was a little unsure about how to set up the real admin user. Surprisingly, the keycloak docs don't tell you how to do this, this is really all they say: * https://www.keycloak.org/server/bootstrap-admin-recovery * https://docs.redhat.com/en/documentation/red_hat_build_of_keycloak/22.0/html/server_administration_guide/creating-first-admin_server_administration_guide So I wrote the directions here. Also added a section on recovery, because I messed up when creating my initial admin user and lost its password 🤦‍♂️ Also fixed some deprecated traefik labels as described in https://git.coopcloud.tech/coop-cloud/example/pulls/3
mac-chaffee added 2 commits 2025-06-22 02:00:00 +00:00
Add docs for initial admin user setup
Some checks failed
continuous-integration/drone/pr Build is failing
abcc59c07c
decentral1se reviewed 2025-06-22 10:11:29 +00:00
decentral1se left a comment
Owner

One minor comment but otherwise, LGTM! Thanks!

One minor comment but otherwise, LGTM! Thanks!
README.md Outdated
@ -38,0 +54,4 @@
You can create a new admin account like this:
```
docker exec -it <keycloak container ID> bash
Owner

abra app run <app> <service> bash?

You can even potentially run this as a one-liner?

`abra app run <app> <service> bash`? You can even potentially run this as a one-liner?
mac-chaffee marked this conversation as resolved
mac-chaffee added 1 commit 2025-06-22 13:42:27 +00:00
Convert bootstrap-admin command to one-liner
Some checks failed
continuous-integration/drone/pr Build is failing
35461d2f59
Owner

Looks fantastic @mac-chaffee, nice one! Merge away 👌

Looks fantastic @mac-chaffee, nice one! Merge away 👌
mac-chaffee merged commit eb5ff04e84 into master 2025-06-24 12:28:53 +00:00
mac-chaffee deleted branch docs-n-deprecations 2025-06-24 12:28:53 +00:00
Sign in to join this conversation.
No description provided.