Skip to main content

Step 2. Create a Realm

A realm manages a set of users, credentials, roles, and groups. A user belongs to and logs into a realm. Realms are isolated from one another and can only manage and authenticate the users that they control.

Create a Realm​

By default there is a single realm in Keycloak called master which is dedicated to managing Keycloak and should not be used for your own applications.

Create your own realm by following these steps:

  1. Open the Keycloak Admin Console
  2. Click on the realm dropdown in the top left corner which has master selected
  3. Click on "Create Realm"

Create realm

  1. Enter a name for your realm (e.g. "myrealm")
  2. Click "Create"

This will create your new realm and select it for you in the realm dropdown.

Configure Your Realm​

The default settings for your realm will suffice, but it is recommended you update the display name:

  1. Open the Keycloak Admin Console
  2. Select "Realm settings" from the main menu
  3. Enter a "Display Name" and "HTML Display Name" to be shown on the login page

Configure realm

  1. Click on the "Save" button