login.lumbung.space/README.md

2.1 KiB

login.lumbung.space

Build Status

login.lumbung.space

Custom theming for the Keycloak SSO service.

Please see default-themes/README.md and lumbung.space/README.md for more info.

Deployment

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 > lumbung.space 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 mesages_en.properties
  • Reload the page, your change should be live

See related documentation and tutorials for the hacking: