Starter theme for keycloak.
$ docker-compose up
The Keycloak server will now be available on https://localhost:8080. You can log into the Administration Console using “admin” as both username and password. The example application will be available on https://localhost:5000.
To use it in your Keycloak realm:
- Create a Keycloak Realm and Client.
- Sign into your realm's admin console.
- Go to the “Themes” tab in “Realm Settings”
- Select “starter” as your login theme, and click on “Save”
The theme will now be used for all Keycloak log in screens on your realm - including logging in to the admin console. If you sign out, you should see the themed log in screen.
The local Keycloak server includes MailDev, a mock SMTP server that you can use to receive and view Keycloak e-mails. It is available on https://localhost:8081.
To set up the local Keycloak server to send e-mails to MailDev:
-
Log in to the local Keycloak server.
-
Go to the “Email” tab in “Realm Settings”
-
Enter the following details:
- Host: maildev
- From: keycloak@keycloak
-
Click on “Save”
-
Click on “Admin” in the top-right-hand corner of the page, and click on “Manage Account”
-
Add an e-mail address to the admin account.
It doesn’t matter what e-mail address you add, as all e-mails will be caught by MailDev. But you do need to add one, otherwise Keycloak will not send e-mails for this account. The local Keycloak server should now be set up to send e-mails to MailDev. To check that it’s working:
- Click on the “Back to Security Admin Console” link
- Click on the “Login” tab in “Realm Settings”
- Enable “Forgot password”, and click on “Save”
- Sign out.
- On the Keycloak log in screen, click on the “Forgot your password?” link
- Enter your username (admin) in the text field, and submit the form.
- Visit MailDev. You should see a reset password e-mail from Keycloak.
MIT