Before Keycloak:

Recommended Folder Structure (Both OS)

iam/
├─ keycloak/
│   ├─ docker-compose.yml
│   ├─ realm-export.json
│   └─ themes/
└─ scripts/
   └─ user-import/

1. Download Docker Desktop:https://www.docker.com/products/docker-desktop/
2. During installation:

• Enable WSL 2
• Enable Hyper-V (if asked)

3. Restart system

4. Verify:

docker --version
docker compose version

ubuntu

sudo apt update
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

docker pull quay.io/keycloak/keycloak:24.0.1

Verify:

docker images

Run Keycloak (Development Mode)

docker run -d ^
--name keycloak ^
-p 8080:8080 ^
-e KEYCLOAK_ADMIN=admin ^
-e KEYCLOAK_ADMIN_PASSWORD=admin ^
quay.io/keycloak/keycloak:24.0.1 ^
start-dev

Access Keycloak

http://localhost:8080

Login:

username: admin
password: admin