Skip to content
Identity and Access Management for Modern Applications, Services and APIs
Java JavaScript HTML CSS XSLT FreeMarker Other
Latest commit fb07559 @stianst stianst Merge pull request #2186 from vmuzikar/master
Fix Adapter Tests dependencies
Failed to load latest commit information.
adapters KEYCLOAK-2428 Log also other accesses
common Bump version to 1.9.0.Final-SNAPSHOT
core KEYCLOAK-1976: Add support for events into admin-rest-client. Also,
dependencies Bump version to 1.9.0.Final-SNAPSHOT
distribution Bump version to 1.9.0.Final-SNAPSHOT
docbook Bump version to 1.9.0.Final-SNAPSHOT
examples Bump version to 1.9.0.Final-SNAPSHOT
federation Bump version to 1.9.0.Final-SNAPSHOT
integration KEYCLOAK-1976: Add support for events into admin-rest-client. Also,
misc KEYCLOAK-2312 Move forms/common-themes to themes
model Bump version to 1.9.0.Final-SNAPSHOT
proxy Bump version to 1.9.0.Final-SNAPSHOT
saml-core Bump version to 1.9.0.Final-SNAPSHOT
server-spi KEYCLOAK-1976: Add support for events into admin-rest-client. Also,
services KEYCLOAK-1976: Add support for events into admin-rest-client. Also,
testsuite Merge pull request #2184 from mhajas/KEYCLOAK-2391
themes Merge remote-tracking branch 'upstream/master'
util Bump version to 1.9.0.Final-SNAPSHOT
wildfly Bump version to 1.9.0.Final-SNAPSHOT
.gitattributes KEYCLOAK-1385 Introduce end-of-line normalization
.gitignore Old experiment with keycloak-server.json embedded into standalone.xml
.travis.yml KEYCLOAK-1420 Removed redundant travis build step.
License.html distro Updated readme
pom.xml Bump version to 1.9.0.Final-SNAPSHOT


Open Source Identity and Access Management for modern Applications and Services.

For more information about Keycloak visit Keycloak homepage and Keycloak blog.


Ensure you have JDK 8 (or newer), Maven 3.2.1 (or newer) and Git installed

java -version
mvn -version
git --version

First clone the Keycloak repository:

git clone
cd keycloak

To build Keycloak run:

mvn install

This will build all modules and run the testsuite.

To build the distribution run:

mvn install -Pdistribution

Once completed you will find distribution archives in distribution.

Starting Keycloak

To start Keycloak during development first build as specficied above, then run:

mvn -f testsuite/integration/pom.xml exec:java -Pkeycloak-server 

To start Keycloak from the appliance distribution first build the distribution it as specified above, then run:

tar xfz distribution/appliance-dist/target/keycloak-appliance-dist-all-<VERSION>.tar.gz
cd keycloak-appliance-dist-all-<VERSION>/keycloak

To stop the server press Ctrl + C.

Help and Documentation

  • Documentation - User Guide, Admin REST API and Javadocs
  • User Mailing List - Mailing list to ask for help and general questions about Keycloak
  • JIRA - Issue tracker for bugs and feature requests


  • Developer documentation
    • Hacking on Keycloak - How to become a Keycloak contributor
    • Testsuite - Details about testsuite, but also how to quickly run Keycloak during development and a few test tools (OTP generation, LDAP server, Mail server)
    • Database Testing - How to do testing of Keycloak on different databases
    • Updating Database - How to change the Keycloak database
  • Developer Mailing List - Mailing list to discuss development of Keycloak


Something went wrong with that request. Please try again.