Chapter 2. Creating the first administrator

After installing Red Hat Single Sign-On, you need an administrator account that can act as a super admin with full permisions to manage all parts of Red Hat Single Sign-On. With this account, you can log into the Red Hat Single Sign-On Admin Console where you create realms and users and register applications that are secured by Red Hat Single Sign-On.


2.1. Creating the account on the local host

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


  1. In a web browser, go to the http://localhost:8080/auth URL.
  2. Supply a username and password that you can recall.

    Welcome page

    Welcome Page

2.2. Creating the account remotely

If you cannot access the server from a localhost address, or just want to start Red Hat Single Sign-On from the command line, use 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>