Installer et demarrer Keycloak 20 min de lecture

Installation avec Docker

Demarrer Keycloak avec Docker

La maniere la plus simple de demarrer Keycloak est d'utiliser Docker :

# Demarrer Keycloak en mode developpement
docker run -d --name keycloak \
  -p 8080:8080 \
  -e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
  -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
  quay.io/keycloak/keycloak:latest \
  start-dev

# Verifier que le conteneur tourne
docker ps
docker logs keycloak
Important : Le mode start-dev est uniquement pour le developpement. En production, utilisez start avec une base de donnees externe et HTTPS.

Avec Docker Compose

# docker-compose.yml
version: "3.9"
services:
  keycloak:
    image: quay.io/keycloak/keycloak:latest
    command: start-dev
    environment:
      KC_BOOTSTRAP_ADMIN_USERNAME: admin
      KC_BOOTSTRAP_ADMIN_PASSWORD: admin
      KC_DB: postgres
      KC_DB_URL: jdbc:postgresql://postgres:5432/keycloak
      KC_DB_USERNAME: keycloak
      KC_DB_PASSWORD: keycloak
    ports:
      - "8080:8080"
    depends_on:
      - postgres

  postgres:
    image: postgres:16
    environment:
      POSTGRES_DB: keycloak
      POSTGRES_USER: keycloak
      POSTGRES_PASSWORD: keycloak
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:
# Demarrer la stack
docker compose up -d

# Verifier les logs
docker compose logs -f keycloak

Verifier l'installation

# Attendre que Keycloak demarre (environ 30 secondes)
curl -s http://localhost:8080/health/ready
# Reponse attendue : {"status":"UP"}

# Verifier les endpoints OIDC
curl -s http://localhost:8080/realms/master/.well-known/openid-configuration | jq .