Fehlerbehebung

Linux-Fehlerbehebung

Behebe häufige Franz-Probleme unter Linux: fehlende GNOME-Tray-Icons, Wayland-Sitzungsprobleme, Signal-Fehler beim ersten Start und KDE-KWallet-Hänger.

Zurück zur Hilfe

Wenn Franz unter Linux Probleme macht, ist das hier die erste Anlaufstelle. Wähle das Symptom, das auf dich zutrifft.

Tray-Icon fehlt unter GNOME

Vanilla GNOME 3+ rendert keine klassischen System-Tray-Icons. Franz läuft, aber sein Tray-Icon erscheint nie. Installiere die AppIndicator-Extension, dann kommt das Tray-Icon zurück.

Shell-Schnipsel, zum Kopieren auf den Kopier-Button klicken
sudo apt install gnome-shell-extension-appindicator

Auf Fedora heißt das Paket genauso, nur mit dnf statt apt. Melde dich einmal ab und wieder an, damit GNOME die Extension lädt. Ubuntu bringt AppIndicator-Support von Haus aus mit.

Wayland-Sitzung: Fenster erscheint nicht oder flackert

Unter manchen Wayland-Sitzungen startet Franz mit leerem Fenster, Tearing-Effekten oder unsichtbarem Mauszeiger. Lass Chromium das Platform-Backend explizit per Start-Flag wählen.

Shell-Schnipsel, zum Kopieren auf den Kopier-Button klicken
./Franz-x86_64.AppImage --ozone-platform-hint=auto

Bei einer installierten Version trägst du dasselbe Flag in die Exec=-Zeile des franz.desktop-Launchers ein. Das ist ein Upstream-Flag von Electron/Chromium, kein Franz-spezifischer Bug.

Signal: "signal not ready, add service first" beim ersten Start

Das mitgelieferte signal-cli kann beim ersten Start manchmal nicht rechtzeitig hochfahren, während die JRE noch initialisiert. Beende Franz, stelle sicher, dass kein weiterer Signal-Desktop- oder signal-cli-Prozess mehr läuft, und starte Franz erneut — der zweite Start klappt in der Regel. Stelle außerdem sicher, dass du Franz 6.1.0 oder neuer einsetzt — frühere Versionen hatten ein verwandtes arm64-Problem, das jetzt behoben ist.

KDE: KWallet hängt beim Start

Unter KDE Plasma kann der Credential-Layer von Chromium beim Start versuchen, KWallet zu öffnen. Wenn KWallet gesperrt ist oder spinnt, hängt der Netzwerkdienst, und Franz friert ein, bevor das Fenster erscheint. Franz 6.1.0 startet unter Linux bereits mit --password-store=basic, das Problem sollte also historisch sein — falls du trotzdem einen Hänger siehst, prüfe, ob das Flag aktiv ist.

Shell-Schnipsel, zum Kopieren auf den Kopier-Button klicken
ps auxf | grep -E 'franz|kwallet'

Falls ein kwalletd-Prozess an Franz hängt, beende ihn, melde den Wallet-Manager ab und starte Franz neu. Der Credential-Store fällt dann auf eine unverschlüsselte Datei in deinem Franz-Nutzerdaten-Verzeichnis zurück.

Kommst du nicht weiter?

Wenn nichts davon zu deinem Symptom passt, schick uns die Details: öffne das Support-Formular und nenne deine Distribution, deine Desktop-Umgebung und den ersten Fehler, den du siehst, wenn du Franz aus einer Shell startest.

Bleib auf dem Laufenden

Produkt-Updates vom Franz-Team alle 2–4 Wochen — Tipps, neue Funktionen und Release-Notes.