Skip to content
This repository was archived by the owner on Feb 22, 2024. It is now read-only.

Commit 59c1ecd

Browse files
committed
Update documentation
- Add Themes - Add Screenshots and update documentation to set up new theme
1 parent 4c90bdf commit 59c1ecd

7 files changed

+22
-14
lines changed

README.md

+22-14
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,15 @@
44

55
TBD
66

7+
## Add Theme(s)
8+
9+
If you would like to see a new theme, e.g., for a new conference, just go to the
10+
`src/main/docker/themes` folder and follow the appropriate instructions from the
11+
[KeyCloak documentation](https://keycloak.gitbooks.io/documentation/server_development/topics/themes.html).
12+
713
## Testing
814

9-
If you want to test the provided DukeCon/Javaland themes perform the following steps:
15+
If you want to test the provided DukeCon/Javaland (or you new) themes, perform the following steps:
1016

1117
### Build Docker test image
1218

@@ -17,32 +23,39 @@ mvn clean package -Plocaltest
1723
### Run Docker test image
1824

1925
```bash
20-
docker run -ti --rm \
26+
docker run -ti --rm \
2127
-e KEYCLOAK_USER=admin \
2228
-e KEYCLOAK_PASSWORD=admin123 \
23-
-p 18080:8080 dukecon-keycloak:1.0-SNAPSHOT
29+
-p 18080:8080 dukecon/dukecon-keycloak:1.1-SNAPSHOT
2430
```
2531

2632
Wait a second for the Docker container to come up!
2733

2834
### Connect to Admin interface
2935

30-
TBD: Screen shot
31-
3236
* Login to KeyCloak Admin Console on http://localhost:18080/auth/admin
3337
* Use the credentials set as Environment variables from the run step
34-
* Select the _master_ realm
38+
![KeyCloak Login Std Theme](images/keycloak-login-stdtheme.png)
39+
40+
### Configure KeyCloak
41+
42+
* Select the _master_ realm (this is by default the only realm)
3543
* Switch to _Login_ tab
3644
** Set all options to _off_
3745
** Save the settings!
46+
![Configure Login](images/keycloak-admin-configure-login.png)
3847
* Switch to _Themes_ tab
39-
** Select _javaland_ as _Login Theme_
48+
** Select _javaland_ (or any other theme) as _Login Theme_
49+
![Configure Themes](images/keycloak-admin-configure-themes.png)
50+
![Select Theme](images/keycloak-admin-choose-theme.png)
4051
** Save the settings!
4152

42-
### Test
53+
### Test new settings
4354

44-
* Log out
55+
* Sign out
56+
![Logout](images/keycloak-signout.png)
4557
* You should see your new Login page
58+
![KeyCloak Login JavaLand Theme](images/keycloak-login-javaland.png)
4659

4760
## KeyCloak Admin Cheat Sheet
4861

@@ -62,11 +75,6 @@ executed from there).
6275
cd /opt/jboss/keycloak/bin
6376
```
6477

65-
### Login to KC
66-
67-
```bash
68-
```
69-
7078
### Delete all users
7179

7280
I recommend to set an environment variable to refer to the realm you are working on
14.1 KB
Loading
154 KB
Loading
148 KB
Loading

images/keycloak-login-javaland.png

116 KB
Loading

images/keycloak-login-stdtheme.png

163 KB
Loading

images/keycloak-signout.png

157 KB
Loading

0 commit comments

Comments
 (0)