Skip to main content
The WebAdmin repository includes a Docker Compose setup that runs Keycloak and PostgreSQL for local development and testing — useful when trying the Keycloak or OAuth2 modes. It ships a preconfigured realm so you can test SSO without manual setup.
The credentials below are for local development only. Never use them in production.

​
What it provides

  • docker-compose.yml — the base services (Keycloak + PostgreSQL)
  • docker-compose.override.yml — an optional run service for the demo application
  • env/keycloak.env — Keycloak environment variables
  • realm/aseeflow-realm.json — a preconfigured realm with a demo user and client
  • ssl/cert.pem, ssl/key.pem — TLS material for Keycloak HTTPS

​
Quick start

Start everything, including the demo application: 
docker compose up -d
The demo is then available at http://localhost:8080/aseeflow-welcome/index.html. Start only the base services (Keycloak + PostgreSQL): 
docker compose -f docker-compose.yml up -d

​
Services

Keycloak
  • URL: http://localhost:9000/auth
  • Admin: keycloak / keycloak1!
  • Realm: aseeflow-realm
  • Demo user: demo / demo
  • OIDC client: aseeflow-identity-service
PostgreSQL
  • Host: localhost:5432
  • Database: keycloak
  • Credentials: keycloak / keycloak
The preconfigured aseeflow-realm includes the aseeflow-identity-service client, a demo / demo user with admin privileges, and the groups aseeflow-admin and aseeflow-users — enough to test WebAdmin with Keycloak immediately.

​
Common commands

docker compose logs -f          # follow logs
docker compose down             # stop services
docker compose down -v          # stop and remove volumes
To start and open the demo in one step: 
# Windows
docker compose up -d --wait; start http://localhost:8080/aseeflow-welcome/index.html
# Linux / macOS
docker compose up -d --wait && open http://localhost:8080/aseeflow-welcome/index.html

​
Custom realm configuration

To build your own realm instead of the bundled one, see the docker/README.md in the WebAdmin repository — it documents the exact Keycloak steps (create the aseeflow realm and aseeflow-identity-service client, the openid scope, a groups membership mapper, the aseeflow-admin / aseeflow-users groups, and the demo user), then exporting your realm over realm/aseeflow-realm.json: 
docker exec keycloak /opt/keycloak/bin/kc.sh export --dir /tmp --realm aseeflow
docker cp keycloak:/tmp/aseeflow-realm.json ./realm/aseeflow-realm.json
docker compose down && docker compose up -d