Keycloak

1

2
[id="creating-first-admin_{context}"]
3
== Creating the first administrator
4

5
After installing {project_name}, you need an administrator account that can act as a _super_ admin with full permissions to manage {project_name}. With this account, you can log in to the {project_name} Admin Console where you create realms and users and register applications that are secured by {project_name}.
6

7
=== Creating the account on the local host
8

9
If your server is accessible from `localhost`, perform these steps.
10

11
.Procedure
12

13
. In a web browser, go to the http://localhost:8080{kc_base_path} URL.
14

15
. Supply a username and password that you can recall.
16
+
17
.Welcome page
18
image:images/initial-welcome-page.png[Welcome page]
19

20
=== Creating the account remotely
21

22
If you cannot access the server from a `localhost` address or just want to start {project_name} from the command line, use the `KEYCLOAK_ADMIN` and `KEYCLOAK_ADMIN_PASSWORD` environment variables to create an initial admin account.
23

24
For example:
25
[source,bash]
26
----
27
export KEYCLOAK_ADMIN=<username>
28
export KEYCLOAK_ADMIN_PASSWORD=<password>
29

30
bin/kc.[sh|bat] start
31
----
32