Chapter 2. Server Initialization

After performing all the installation and configuration tasks defined in the Server Installation and Configuration Guide, you will need to create an initial admin account. Red Hat Single Sign-On does not have any configured admin account out of the box. This account will allow you to create an admin that can log into the master realm’s administration console so that you can start creating realms, users and registering applications to be secured by Red Hat Single Sign-On.

If your server is accessible from localhost, you can boot it up and create this admin user by going to the http://localhost:8080/auth URL.

Welcome Page

initial welcome page

Simply specify the username and password you want for this initial admin.

If you cannot access the server via a localhost address, or just want to provision Red Hat Single Sign-On from the command line you can do this with the …​/bin/add-user-keycloak script.

add-user-keycloak script

add user script

The parameters are a little different depending if you are using the standalone operation mode or domain operation mode. For standalone mode, here is how you use the script.


$ .../bin/ -r master -u <username> -p <password>


> ...\bin\add-user-keycloak.bat -r master -u <username> -p <password>

For domain mode, you have to point the script to one of your server hosts using the -sc switch.


$ .../bin/ --sc domain/servers/server-one/configuration -r master -u <username> -p <password>


> ...\bin\add-user-keycloak.bat --sc domain/servers/server-one/configuration -r master -u <username> -p <password>