Keycloak is an open-source identity and access management solution, which functions as a single sign-on mechanism for web applications and RESTful web services.
Zerops recipe for Keycloak includes a bootstrapped Keycloak app with PostgreSQL DB.
You can either click the deploy button to deploy directly on Zerops, or manually copy the import yaml to the import dialog in the Zerops app.
- Keycloak running on a Zerops Java service
- Zerops PostgreSQL 17 service as database
- Utilization of a Zerops built-in environment variables system
Base of the recipe is ready for production, the difference comes down to:
- Use a highly available version of the PostgreSQL database (change
modefromNON_HAtoHAin recipe YAML,dbservice section)
If you want to modify your existing Keycloak app to efficiently run on Zerops, these are the general steps we took:
- Add zerops.yml to your repository. Our example includes installation of a specified version, admin bootstrap and health checks.
- Set
KC_HOSTNAME_STRICTtofalse, to enablezerops.appsubdomain access. Should be skipped if the Keycloak is hosted on its own domain, setKC_HOSTNAMEto the domain instead.
Bootstrap admin login for this recipe is tempadmin with automatically generated password,
which can be found under KC_BOOTSTRAP_ADMIN_PASSWORD name in the Zerops Environment variables section of app service.
Both KC_BOOTSTRAP_ADMIN_USERNAME and KC_BOOTSTRAP_ADMIN_PASSWORD envs may be removed in UI after a permanent admin account has been created.
Need help setting your project up? Join Zerops Discord community.