Custom Keycloak theme
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
decentral1se 10581b44b1 Unrecommended style changes 11 months ago
bin Add convenience script and makefile for hacking 2 years ago
default-themes Lay out custom theme and docs 2 years ago Unrecommended style changes 11 months ago
.drone.yml Add drone configuration 2 years ago
.gitignore Copy/pasta over keycloak base theme 2 years ago Drop that, already said 2 years ago
makefile Destroy the container automatically 2 years ago

Build Status

Custom theming for the Keycloak SSO service.

Please see default-themes/ and for more info.


Just send commits and the Drone CI/CD configuration will take care of the rest.

Custom theming workflow

You'll need a local Docker installation.

Then run a local Keycloak instance and mount the theme into the container with the following (makefile source):

$ make

An example workflow for customising the login theme would be:

  • Log into localhost:8080 with username: admin and password: admin
  • Go to Realm Settings > Themes
  • Choose a custom login theme via Login Theme > and click Save
  • Sign out and you'll be redirected to the login page
  • Now, test you can make an edit and it is reflected on reload, change the "Username or email" string in
  • Reload the page, your change should be live

See related documentation and tutorials for the hacking: