feat: add base code for keycloak and docker

Author: agus-darmawan

.env.example

@@ -0,0 +1,14 @@
+# PostgreSQL
+POSTGRES_DB=keycloak
+POSTGRES_USER=keycloak
+POSTGRES_PASSWORD=keycloak_password
+
+# Keycloak Admin
+KEYCLOAK_ADMIN=admin
+KEYCLOAK_ADMIN_PASSWORD=admin123
+
+# Database
+KC_DB=postgres
+KC_DB_URL=jdbc:postgresql://postgres:5432/keycloak
+KC_DB_USERNAME=keycloak
+KC_DB_PASSWORD=keycloak_password

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: Keycloak Docker CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  keycloak-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Prepare env
+        run: cp .env.example .env
+
+      - name: Start containers
+        run: docker compose up -d
+
+      - name: Wait for Keycloak
+        run: |
+          for i in {1..15}; do
+            curl -f http://localhost:8080 && exit 0
+            sleep 5
+          done
+          exit 1
+
+      - name: Stop containers
+        run: docker compose down

.gitignore

@@ -0,0 +1,9 @@
+### macOS ###
+# General
+.DS_Store
+
+# Environment Variables
+.env
+
+# Visual Studio Code
+.vscode/

README.md

@@ -0,0 +1,77 @@
+# Keycloak SSO Docker Environment
+
+A complete Docker-based **Keycloak SSO** environment using PostgreSQL as the database.
+
+This repository is suitable for:
+- Single Sign-On (SSO)
+- OAuth2 / OpenID Connect authentication
+- Local development & testing
+- CI pipelines
+
+---
+
+## 🚀 Services
+
+- **Keycloak** (latest)
+- **PostgreSQL** (persistent storage)
+
+---
+
+## 📦 Requirements
+
+- Docker
+- Docker Compose v2
+
+---
+
+## ⚙️ Environment Setup
+
+Copy environment example:
+
+```bash
+cp .env.example .env
+```
+
+Edit values as needed.
+
+---
+
+## ▶️ Run Keycloak
+
+```bash
+docker compose up -d
+```
+
+---
+
+## 🌐 Access Keycloak
+
+- Admin Console: http://localhost:8080
+- Username: `admin`
+- Password: value from `.env`
+
+---
+
+## 🔐 Realm Import
+
+Place realm JSON files inside:
+
+```
+./realm
+```
+
+They will be automatically imported on startup.
+
+---
+
+## 🧪 Stop Containers
+
+```bash
+docker compose down
+```
+
+Remove volumes:
+
+```bash
+docker compose down -v
+```

docker-compose.yml

@@ -0,0 +1,31 @@
+services:
+  postgres:
+    image: postgres:16
+    container_name: keycloak_postgres
+    restart: unless-stopped
+    env_file:
+      - .env
+    volumes:
+      - kc_postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $POSTGRES_USER"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  keycloak:
+    image: quay.io/keycloak/keycloak:latest
+    container_name: keycloak
+    command: start-dev --import-realm
+    env_file:
+      - .env
+    ports:
+      - "8080:8080"
+    depends_on:
+      postgres:
+        condition: service_healthy
+    volumes:
+      - ./realm:/opt/keycloak/data/import
+
+volumes:
+  kc_postgres_data: