Troubleshooting

Port already in use

lsof -i :3000
kill -9 <PID>

Docker infra not healthy

docker compose --env-file .env.development -f docker-compose.dev.yml ps
docker compose --env-file .env.development -f docker-compose.dev.yml logs -f --tail=200

Database connection issues

• Verify compose is up and healthy.
• Re-check env vars in .env.development.
• Reset infra volumes if needed (dev only).

Keycloak slow start

Keycloak có thể mất 1–2 phút để ready. Check logs:

docker compose --env-file .env.development -f docker-compose.dev.yml logs -f keycloak --tail=200