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.
3wc 1e924472bb
continuous-integration/drone/push Build is passing Details
continuous-integration/drone Build is passing Details
Update to newer Keycloak base template
3 months ago
bin Add convenience script and makefile for hacking 2 years ago
default-themes Update to newer Keycloak base template 3 months ago Unrecommended style changes 1 year ago
.drone.yml fix: new themes path 4 months 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: