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.