2021-05-05 09:37:28 +00:00
# login.lumbung.space
2021-05-05 11:13:10 +00:00
[](https://drone.autonomic.zone/ruangrupa/login.lumbung.space)
2021-05-05 09:42:39 +00:00
> [login.lumbung.space](https://login.lumbung.space)
2021-05-05 09:37:28 +00:00
[Custom theming ](https://www.keycloak.org/docs/latest/server_development/index.html#_themes ) for the Keycloak SSO service.
2021-05-05 09:53:58 +00:00
Please see [default-themes/README.md ](./default-themes/README.md ) and [lumbung.space/README.md ](./lumbung.space/README.md ) for more info.
2021-05-05 11:31:10 +00:00
## Deployment
Just send commits and the [Drone CI/CD configuration ](./.drone.yml ) will take care of the rest.
2021-05-24 10:53:30 +00:00
## Custom theming workflow
2021-05-05 11:31:10 +00:00
You'll need a local [Docker ](https://docs.docker.com/engine/install/debian/ ) installation.
2021-05-24 10:52:43 +00:00
Then run a local Keycloak instance and mount the theme into the container with the following ([makefile source](./makefile)):
```
$ make
2021-05-05 11:31:10 +00:00
```
2021-05-24 10:52:43 +00:00
An example workflow for customising the login theme would be:
- Log into [localhost:8080 ](http://localhost:8080 ) with username: `admin` and password: `admin`
- Go to [Realm Settings > Themes ](http://localhost:8080/auth/admin/master/console/#/realms/master/theme-settings )
- 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 ](./lumbung.space/login/messages/messages_en.properties )
- Reload the page, your change should be live
2021-05-05 11:31:10 +00:00
See related documentation and tutorials for the hacking:
- [Create a custom theme for Keycloak ](https://auscunningham.medium.com/create-a-custom-theme-for-keycloak-8781207be604 )
- [Change Login Theme in Keycloak Docker image ](https://austincunningham.ddns.net/2020/changekeycloakdockertheme )
- [Keycloak themes documentation ](https://www.keycloak.org/docs/latest/server_development/index.html#_themes )
- [Keycloak Github repo for default themes ](https://github.com/keycloak/keycloak/tree/master/themes/src/main/resources/theme )
- [Keycloak container documentation ](https://github.com/keycloak/keycloak-containers/tree/master/server )
