Getting Started
Start here to set up your first realm: the basic realm configuration, branding the login UI, sending email, and the checklist to run through before you launch. For step-by-step walkthroughs of Keycloak itself, see the Tutorials.
Dashboard
To gain initial access to a Keycloak instance (realm or dedicated) on Phase Two, you must first sign up in the Phase Two Dashboard. You will be required to provide an email or link an SSO provider.
Realm Configuration
Phase Two provides a sensible set of configuration defaults designed for common use cases, but you may want to adjust certain settings to better fit your specific requirements. Your initial configuration may vary depending on how you are using Phase Two (such as self-service, dedicated deployments, or Docker images). While many options may already be set by default, this section explains the purpose of each setting and highlights basic changes you might consider to tailor the functionality to your needs.
Customizing UI / Theming
Phase Two ships a unified theme called phasetwo-ui that covers all four Keycloak theme types — login, account, admin, and email — in a single package. It is built with Keycloakify and shadcn/ui and is the default theme on Phase Two hosted instances.
Emails
This section details setting up email delivery with your email service and customizing the content templates to match your brand and messaging.
Go-Live Checklist
This page covers what to confirm before you move a Phase Two hosted cluster into production. Much of the underlying configuration is beyond the scope of a checklist, so each item links to the page that explains it. The goal is to make sure you have thought about each area, not to explain each one here.
Sample Application
The quickest way to see authentication working is to run one of our example applications against your own realm. Once you have a Phase Two cluster and a realm, pick the example that matches your stack from the p2-inc/examples repository. Each example is a standalone project with its own README, sample environment file, and in most cases a live deployed version you can try first.