This repository deploys the Keycloak.X Identity and Access Management Solution to Heroku. It is based of Keycloak's official docker image with some slight modifications to use the Heroku variable for PORT and DATABASE_URL properly, also enabling the edge proxy mode by default.

Keycloak.X uses Quarkus as the platform to build Keycloak. Compared to WildFly this gives faster startup-time and lower memory footprint which makes it possible for us to use a free dyno instance together with a hobby-dev Postgres database attached.

You only need to have a Heroku (free) account and everything will be sorted out with a click of a button via the web console :)

If you don't want to use the Deploy to Heroku button above for any reason, you need the Heroku CLI installed, so you can deploy this manually in a few steps after cloning this repository:

heroku apps:create --manifest
heroku addons:create heroku-postgresql:hobby-dev
heroku stack:set container
git push heroku main

• In some cases, Heroku stops the service startup because it becomes unresponsive given the latency of the automatic database migration execution in the first initialization. If that happens, you can request for changing the boot timeout manually for you app.

• Keycloak.X Docker Image
• Keycloak.X Server Configuration
• Introducing Keycloak.X Distribution
• Deploy Keycloak to Heroku (Wildfly)