Keycloak-config-cli

Keycloak-config-cli is a tool that automates the setup of Keycloak, a popular identity management system.

  • Automation
  • Infrastructure
  • Security
Keycloak-config-cli is a tool that automates the setup of Keycloak, a popular identity management system. It allows you to import settings—such as users and login rules—from a file, ensuring your security configuration is consistent, easily repeatable, and updated without manual effort.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

78/100 Good

Maintained
100last commit 1 day ago
Popular
621,221 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
95no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
1,221
Open issues
41
Last commit
2026-11-20
Latest release
v6.5.1
License
Apache-2.0
Activity
rising

Checked yesterday - source: GitHub (adorsys/keycloak-config-cli)

Resources & Compatibility

Requirements not published yet.

Checked 23 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Keycloak before using the CLI On Windows, run bin\kc.bat start-dev from the Keycloak folder to start a local Keycloak server for testing. keycloak-config-cli needs a reachable Keycloak server, or it cannot connect and will fail. source
  • Use the example admin login If you start Keycloak from the Kubernetes example, it creates an admin account named admin with password admin. You need those login details so keycloak-config-cli can sign in and make changes. source
  • Create a client for keycloak-config-cli kcreg.sh is a helper tool that registers apps with Keycloak. Save the Initial Access Token with kcreg.sh config initial-token $TOKEN, then create a client with kcreg.sh create -s clientId=myclient so the CLI has a client identity to log in with. source

Fetched 48 days ago - each note links to its source

Alternatives (12)

  • Auth0 - You can connect any application (written in any language or on any stack) to Auth0 and define its Connection, the method used to authentica…
  • Authelia - Authelia is an open-source authentication and authorization server that provides login, multi-factor authentication, and single sign-on for…
  • Better Auth - Better Auth is a framework-agnostic authentication and authorization library for TypeScript that lives inside your application.
  • FusionAuth - FusionAuth is a secure tool that manages user logins and registrations for your website or mobile application.
  • Keycloak - Keycloak is an open-source Identity and Access Management platform for adding authentication to self-hosted applications.
  • SuperTokens MySQL - SuperTokens is an open-source, self-hosted user authentication server that adds secure login and session management to your apps.
  • Tinyauth - Tinyauth is a lightweight OpenID Connect authentication and authorization server that adds login and access controls to self-hosted apps be…
  • VoidAuth - VoidAuth is an open-source authentication platform for self-hosted applications.
  • ZITADEL - Zitadel is an open-source identity and access management platform that provides authentication, single sign-on, multi-factor authentication…
  • authentik - Authentik is an open-source identity provider that adds flexible single sign-on, user management, and common sign-in protocol support to se…
  • casdoor - Casdoor is an open-source, self-hosted identity and access management platform that centralizes single sign-on, authentication, and authori…
  • openam - OpenAM is an open-source access management platform providing authentication, single sign-on (SSO), and authorisation so users log in once…

Checked 40 days ago - source: AlternativeTo

Common questions

Do I need a running Keycloak server before running keycloak-config-cli?

Yes. The CLI needs a reachable Keycloak server, otherwise it cannot connect and will fail.

Can keycloak-config-cli log in using a registered client identity?

Yes. You can register an app with kcreg.sh, save an initial access token, and create a client so the CLI has a client identity to log in with.

Which environment variables are used in the documented Docker import?

The example uses KEYCLOAK_URL, KEYCLOAK_USER, KEYCLOAK_PASSWORD, and IMPORT_FILES_LOCATIONS. It also mounts a local config directory to /config.

Does keycloak-config-cli recreate resources on every import?

No. It applies configuration changes rather than re-creating resources from scratch. A run with nothing to change completes as a no-op.

Can one set of realm files target multiple environments?

Yes. With import.var-substitution.enabled=true, you can reference environment variables, files, Base64 values, system properties, URLs, and DNS lookups. Recursive substitution is supported.

Answers sourced from adorsys.github.io, github.com, github.com

Community

Collected 48 days ago - public community threads