Fehlerbehebung¶
In der App¶
Die häufigsten Fragen aus dem Alltag – falsches Konto, Laufwerk erscheint nicht, Zugriff noch nicht gewährt, vergessenes Passwort – beantwortet das Benutzerhandbuch: Häufige Fragen und Probleme.
Weitere Fälle:
| Symptom | Ursache / Lösung |
|---|---|
| Windows: „WinFsp ist nicht installiert oder nicht ladbar“ | WinFsp ab 2.1 installieren (Installation), danach Krywerk neu starten |
| macOS: „FUSE-T … nicht installiert“ | FUSE-T installieren; Krywerk startet auch ohne, kann aber nichts einhängen |
| Linux: „/dev/fuse fehlt …“ | FUSE-Modul laden (sudo modprobe fuse) und Paket fuse3 installieren; in Containern /dev/fuse freigeben |
| Linux: Fenster bleibt leer oder schließt sich sofort | WebKitGTK 4.1 fehlt bzw. Grafiktreiber-Problem: Krywerk aus dem Terminal starten und Meldungen prüfen; WEBKIT_DISABLE_COMPOSITING_MODE=1 versuchen |
| Linux: „Passwort merken“ geht nicht | Kein Schlüsselbund in der Sitzung (KWallet oder GNOME-Schlüsselbund nötig) |
| Linux: kein Symbol im Infobereich (GNOME) | Erweiterung AppIndicator and KStatusNotifierItem Support installieren |
| Hinweis „Die Einstellungen waren beschädigt …“ | Krywerk hat die alte Datei als config.json.defekt-<Zeit> gesichert; Laufwerke neu hinzufügen oder Datei reparieren |
| „Der Server lehnt das Entsperren wegen seiner Lizenz ab (HTTP 402)“ | Gilt nur für den Cryptomator Hub; Lizenz beim Hub-Betreiber erneuern |
| Laufwerk langsam, Änderungen von anderen Geräten erscheinen spät | Einstellungen › Allgemein › Erweitert › Zwischenspeicher aus- bzw. einschalten (gilt beim nächsten Einhängen) |
Was im Protokoll steht und wo es liegt: Konfiguration › Protokoll der App.
Krywerk Server¶
| Symptom | Ursache / Lösung |
|---|---|
check: „Discovery meldet issuer … statt …“ |
KRYWERK_SERVER_OIDC_ISSUER muss exakt dem iss der Tokens entsprechen (ohne / am Ende) |
check: Anbieter nicht erreichbar |
OIDC_INTERNAL_URL prüfen; Server braucht ausgehenden Zugriff zum Anbieter; eigene CA → SSL_CERT_FILE |
| Apps: „Server nicht vertrauenswürdig“ | public_url/KRYWERK_DOMAIN muss HTTPS sein; Apps akzeptieren HTTP nur für localhost |
| Alle Anfragen 401 | Uhrzeit des Servers (NTP), Issuer, ggf. OIDC_AUDIENCE falsch gesetzt; Tokens eines anderen Clients (azp) – dann OIDC_CLIENT_ID bzw. OIDC_ALLOWED_CLIENTS prüfen |
| Alle Anfragen 403 | Rolle user fehlt (Standardrolle im Realm) bzw. ROLE_USER leeren, wenn der Anbieter keine Rollen liefert |
| „Darf keine Team-Ordner anlegen“ | Rolle create-vaults zuweisen |
| Gruppe nicht auffindbar | Mitglied muss sich einmal angemeldet haben; Gruppen-Claim im Token? (GROUPS_CLAIM) |
restore: „antwortet noch“ |
Server zuerst stoppen (restore.sh macht das) |
| Web-Verwaltung: „Invalid parameter: redirect_uri“ beim Anmeldedienst | Rücksprung https://<KRYWERK_DOMAIN>/verwaltung/anmeldung am Client krywerk-verwaltung eintragen |
| Web-Verwaltung: „Sitzung abgelaufen“ bei jedem Formular | Proxy überschreibt Referrer-Policy mit no-referrer (Browser senden dann Origin: null) – in Caddy ?Referrer-Policy verwenden |
| Web-Verwaltung: 403 „nur aus dem internen Netz“ | Caddy-Block @verwaltung_extern anpassen |
| Web-Verwaltung: kein Menü „Personen“ | Rolle admin fehlt im Token (Rollen-Claim) |
| Symptom | Ursache / Lösung |
| --- | --- |
| HTTP 429 „zu viele Anfragen“ | Anfragebegrenzung je IP (rate_limit.*); hinter einem Proxy trust_proxy setzen, sonst teilen sich alle Nutzer die IP des Proxys |
| Server startet nicht: „unbekannte Option“ | Tippfehler in der TOML-Datei; krywerk-server check nennt die Option |
| Server startet nicht: Datenbank ist neuer | Eine neuere Version hat die Datenbank migriert; diese Version wieder einsetzen oder Sicherung von vorher zurückspielen |