Skip to content

Commit

Permalink
Add section on how to add the initial admin user
Browse files Browse the repository at this point in the history
Closes keycloak#10531

Co-authored-by: Dominik Guhr <89905860+DGuhr@users.noreply.github.com>
  • Loading branch information
2 people authored and abstractj committed Mar 4, 2022
1 parent 722ce95 commit e1318d5
Showing 1 changed file with 8 additions and 0 deletions.
8 changes: 8 additions & 0 deletions docs/guides/src/main/server/configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,14 @@ is needed for deploying Keycloak in production.
By default, the configuration options for the production mode are commented out in the `conf/keycloak.conf`. These examples
are meant to give you an idea about the main settings to consider when running in production.

== Setup of the initial admin user

The initial admin user can be added manually using the web frontend when accessed from localhost or automatically using environment variables.

To add the initial admin user using environment variables, set `KEYCLOAK_ADMIN` for the initial admin username and `KEYCLOAK_ADMIN_PASSWORD` for the initial admin password.
Keycloak uses them at the first startup to create an initial user with administration rights.
Once the first user with administrative rights exists, you can use the UI or the command line tool `kcadm.[sh|bat]` to create additional users.

== Unsupported server options

In most cases, the available options from the server configuration should suffice to configure the server.
Expand Down

0 comments on commit e1318d5

Please sign in to comment.