Skip to Content

Migrate from Keycloak to Faable Auth

Short answer: Migrating from self-hosted Keycloak to Faable Auth removes the servers, upgrades, and database you currently operate, while keeping the same OAuth 2.0 / OpenID Connect standards. You map each Keycloak realm to a Faable Account, your Keycloak clients to Faable Clients, and your identity providers to Faable Connections, then export your users and import them into Faable. The motivation is almost always the same: stop operating identity infrastructure while staying 100% in Europe under GDPR — Faable Auth is fully managed, so there is nothing to patch, scale, or back up.

Concept mapping

KeycloakFaable AuthNotes
RealmAccountYour isolated identity boundary
ClientClientSPA, native, regular web, or M2M
Identity Provider (social/OIDC/SAML)Connectionsocial, oidc categories
User federation (LDAP/AD)OIDC/enterprise ConnectionConnect via standard protocols
Authentication SPI (Java)ActionsCustom in-flow logic, no Java/SPI to maintain
Admin REST APIManagement APICalled with client credentials
Self-hosted servers + DBFully managedNo infrastructure for you to run

Migration steps

  1. Create your Account in the Faable Dashboard  and note your issuer URL.
  2. Map realms to accounts. Each Keycloak realm becomes a Faable Account; if you ran one realm per customer, model those as teams/accounts.
  3. Recreate Connections. Translate each Keycloak Identity Provider into a Faable Connection (social or generic OIDC), reusing upstream client credentials.
  4. Recreate Clients with the same redirect URIs, web origins, and flow types.
  5. Replace SPIs with Actions. Move custom authenticator SPIs to Actions — JavaScript in the flow instead of compiled Java extensions.
  6. Export and import users. Use Keycloak’s export (realm-export / Admin REST API) to extract users and credentials, then import into Faable. Password hashes can be carried over so users don’t reset.
  7. Decommission your Keycloak deployment once traffic is on Faable — and reclaim the operational time you spent running it.

What you stop maintaining

  • Server provisioning, JVM tuning, and clustering
  • Database backups, migrations, and version upgrades
  • Security patching of the Keycloak runtime
  • High-availability and scaling for login spikes

Last updated on

Last updated on