desktop/CopyToKeycloak/WAS_DU_TUN_MUSST.md

Was Du Tun Musst

1. Theme nach Keycloak kopieren

Den Ordner

• CopyToKeycloak/theme/kusche-desktop

in das Keycloak-Themes-Verzeichnis kopieren.

Typische Ziele:

• Container: /opt/keycloak/themes/
• VM/Bare Metal: <KEYCLOAK_HOME>/themes/

Danach muss dort existieren:

• /opt/keycloak/themes/kusche-desktop/login/theme.properties

2. Keycloak neu laden

Wenn du in Entwicklung arbeitest:

• Keycloak neu starten

Wenn du in Produktion Theme-Caches aktiv hast:

1. Keycloak stoppen oder neu starten
2. falls noetig Theme-Cache loeschen:
   • data/tmp/kc-gzip-cache

3. Theme nur fuer den Desktop-Client setzen

In Keycloak:

1. Realm KuscheBerlin oeffnen
2. Client desktop-kusche-berlin oeffnen
3. Die Login-Theme-Override fuer den Client auf kusche-desktop setzen

Wichtig:

• Das Theme soll nicht pauschal als Realm-Login-Theme fuer alle Clients gesetzt werden, wenn andere Clients das Standard-Keycloak-Login behalten sollen.

Falls deine Keycloak-Version im Client-UI keine direkte Login-Theme-Auswahl anzeigt:

• pruefen, ob die Client-spezifische Login-Theme-Option in den Client-Einstellungen / Advanced Settings vorhanden ist
• falls nicht vorhanden, bleibt als saubere Alternative nur:
  • eigener Realm fuer Desktop
  • oder spaeter ein Theme Selector SPI

4. Testen

Danach testen:

1. https://staging.desktop.kusche.berlin
2. https://desktop.kusche.berlin

Erwartung:

• fuer den Client desktop-kusche-berlin erscheint das neue Desktop-Login-Theme
• nach erfolgreichem Login geht es zur Desktop-Shell zurueck

5. Falls das Theme nicht erscheint

Dann diese Punkte pruefen:

• Theme-Ordner liegt wirklich im Keycloak-themes/-Verzeichnis
• Verzeichnisname ist exakt kusche-desktop
• theme.properties liegt unter kusche-desktop/login/
• Keycloak wurde nach dem Kopieren neu gestartet
• Cache wurde geleert
• wirklich der Client desktop-kusche-berlin wird verwendet

6. Welche Datei du spaeter bei Aenderungen ersetzt

Wenn du nur Styling aendern willst, reicht meist:

• theme/kusche-desktop/login/resources/css/desktop-kusche.css

Wenn du die Struktur aendern willst:

• theme/kusche-desktop/login/login.ftl

7. Was ich bewusst nicht fuer dich serverseitig tue

Diese Schritte musst du selbst auf dem Keycloak-System machen:

• Dateien nach Keycloak kopieren
• Keycloak neu starten
• Client-Theme-Override setzen

Das Projekt hier erzeugt nur den fertigen Theme-Ordner.