Install the realm manually - Install the realm manually - Alfresco - Alfresco Content Services - Alfresco/Alfresco-Content-Services/23.4/Alfresco-Content-Services/Configure/Keycloak/Install-Keycloak/Install-the-Alfresco-Realm/Install-the-realm-manually - 23.4 - 23.4

Alfresco Content Services

Platform
Alfresco
Product
Alfresco Content Services
Release
23.4
License
ft:lastPublication
2026-04-22T22:35:19.567073
ft:locale
en-US

Prerequisites: Git and Helm are installed.

To install the Alfresco Realm manually:

  1. Clone the https://github.com/Alfresco/alfresco-identity-service GitHub repository:
    git clone https://github.com/Alfresco/alfresco-identity-service.git
    
  2. Checkout the required tag based on the Keycloak and Alfresco Keycloak Theme versions specified in the Supported platforms page.

    For example:

    git checkout keycloak-21.1.2_theme-0.3.5
    
  3. (Optional) Customize the realm section of the sample values.yaml file by editing it locally, if needed - for example to define additional users, roles, groups, and override the allowed redirectUris.
  4. Move to the root of the cloned repository and run the following command.

    Make sure that KC_DISTRIBUTION is set to the root of your Keycloak installation.

    You can use either Git Bash or WSL (see How to install Linux on Windows with WSL on the Microsoft documentation: https://learn.microsoft.com/) if using Windows:

    helm template helm/alfresco-keycloak \
      -f helm/alfresco-keycloak/values.yaml \
      --show-only templates/realm-secret.yaml |
      grep '\"alfresco-realm.json\"' | awk '{ print $2}' |
      sed -e 's/\"$//' -e 's/^\"//' | base64 --decode | jq '.' >$KC_DISTRIBUTION/data/import/alfresco-realm.json