Deploy with an agent
Copy agent prompt
Before you start
Connect your AWS account using the Spring Winter quickstart. You need postgreSQL and a canonical HTTPS hostname. Check the upstream deployment instructions and pin a release before you deploy. Source repository.Create and connect the database
- Create a private SQL database with PostgreSQL. If you already have a database for this deployment, verify that the engine and version match the pinned app release. Wait for the database to be ready.
- Open Connect on the database. Use the writer endpoint, port, database name and application credentials. Create the application database and role if needed. Confirm that the application and migration process can reach the private writer.
- Set
KC_DB=postgres,KC_DB_URL,KC_DB_USERNAMEandKC_DB_PASSWORD. Keep the writer private and configure database TLS for your deployment. Put secret values in runtime configuration or the migration process’s secret store. - Start Keycloak in production mode and let it initialize the schema. Wait for readiness before creating realms.
Configure the deployment
- Select a Spring Winter project in the AWS Region you want to use. Use a web server for the HTTP app and configure dependencies before you start it.
- Use quay.io/keycloak/keycloak with the production start command and PostgreSQL settings.
- For load balancer TLS termination configure KC_HTTP_ENABLED, KC_PROXY_HEADERS and KC_HOSTNAME for your topology.
- Use the release’s bootstrap admin settings once.
- Keycloak may serve readiness on a separate management port.
- Verify that your Spring Winter health check uses a supported path on the configured target port.