keycloak-theme/README.md

pub.solar Keycloak theme

Development setup

To start a Dev Keycloak instance that can show the pub.solar theme, you need to do the following:

1. Go into Keycloak's Administration Console, and export the pub.solar realm config. In Keycloak, open the pub.solar realm, click on the menu item "Realm settings", open the dropdown "Action", and click "Partial export". Move the generated JSON file into ./.dev-imports in this repo.

2. Run the following command:

docker run \
  --name keycloak-theme-dev \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin \
  -v $(pwd):/opt/keycloak/themes/pub.solar \
  -v $(pwd)/.dev-import:/opt/keycloak/data/import \
  quay.io/keycloak/keycloak:21.1.1 \
  start-dev --import-realm --features="declarative-user-profile"

3. After this, you can start and stop the container using docker start keycloak-theme-dev and docker-stop keycloak-theme-dev.

4. Connect to the local Keycloak instance at http://localhost:8080 and open the Administration Console. Login with username: admin, password: admin.

5. To view the theme in action, open http://localhost:8080/realms/pub.solar/account