Dieser Leitfaden beschreibt die Installation der Desktop-App kDrive von Infomaniak auf einem Computer mit einem Linux-Betriebssystem. Sie ermöglicht anschließend die Synchronisation Ihrer Dateien vom Computer mit kDrive.

Vorwort

• Unter diesem Betriebssystem sind einige Funktionen von kDrive nicht verfügbar, wie z. B. die Option Lite Sync oder das Kontextmenü bei Rechtsklick.
• Die kDrive-App wird von Infomaniak offiziell nur auf den folgenden Systemen unterstützt:
  • Ubuntu 22.04 LTS (und neuer)
  • Desktop-Umgebungen: GNOME oder KDE
• Die Anwendung kann möglicherweise auf anderen Linux-Distributionen oder mit anderen Desktop-Umgebungen funktionieren. Infomaniak bietet jedoch keinen Support für die Installation oder Ausführung der Anwendung außerhalb der oben genannten Konfigurationen.

Installation von kDrive unter Linux

Voraussetzungen

• Herunterladen Sie die Desktop-App kDrive für Linux (Dateityp .AppImage)
• Fuse2 (benötigt, um eine appimage):
  • Ab Version 23.04 (und neuer) von Ubuntu passiert nach dem Doppelklicken auf die Datei AppImage nichts.
  • Die neuesten Ubuntu-Versionen verwenden eine "zu" neue Version von FUSE (die "Filesystem in User Space"-Schnittstelle, auf der AppImages basieren, um zu funktionieren), für die AppImages nicht konzipiert sind.
  • AppImages benötigen FUSE v2, um zu funktionieren: sudo apt install libfuse2
• D-Bus
• Gnome-keyring oder kwallet (in der Regel bereits auf Ihrem Computer vorhanden, außer bei bestimmten Light-Distributionen)

Als Nächstes:

1. Legen Sie die Datei in einen Ordner mit dem Namen "Anwendungen".
2. Klicken Sie mit der rechten Maustaste auf die Datei und wählen Sie Berechtigungen.
3. Wählen Sie die Option "Ausführen des Datei als Programm erlauben" aus.

Damit kDrive beim Start ausgeführt wird, fügen Sie die Datei in "Startprogramme" oder ähnlich hinzu.

Bekannte Probleme und Lösungen

Synchronisation blockiert oder Fehler "Inotify watches"

Wenn die Synchronisation zu stocken scheint (z.B. Schritt 1/10) oder die Protokolle (Logs) den Fehler Out of memory or limit number of inotify watches reached! anzeigen, bedeutet dies, dass die Systemgrenze zur Überwachung der Ordner erreicht ist.

• Aktuelle Grenze überprüfen: cat /proc/sys/fs/inotify/max_user_watches
• Grenze erhöhen: Um den Wert zu verdoppeln (z.B. auf 131072), führen Sie aus: 
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf
  Dann anwenden mit: sudo sysctl -p

Die Anwendung stürzt beim Öffnen ab (AppArmor / Wayland)

Auf einigen Ubuntu-Versionen (24.04+) oder Debian kann die Sicherheit AppArmor das Öffnen des Anmeldefensters blockieren.

• AppArmor-Lösung: Installieren Sie die Hilfsprogramme: sudo apt install apparmor-utils. Erstellen Sie dann das Profil für kDrive: sudo aa-autodep /pfad/zu/Ihrer/kDrive.AppImage und starten Sie den Dienst neu: sudo service apparmor restart.
• Wayland-Konflikt: Wenn die Anwendung speziell unter Wayland abstürzt, versuchen Sie, die Verwendung von X11 zu erzwingen, indem Sie die Anwendung über das Terminal mit dem Befehl starten: 
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Probleme mit der Anzeige des Symbols oder des Fensters

• Unsichtbares Symbol (Gnome): Installieren Sie die Erweiterung AppIndicator Support; beachten Sie, dass die Erweiterung Dash to Panel dafür bekannt ist, die Menüs der Anwendung unsichtbar zu machen und nicht empfohlen wird.
• Synthesefenster kann nicht geöffnet werden: Stellen Sie sicher, dass die Bibliotheken libfuse2 und libdbus-1-dev auf Ihrem System installiert sind.
• KDE Wayland: Wenn die Oberfläche nicht korrekt angezeigt wird, fügen Sie diese Zeilen zu Ihrer Datei ~/.config/kdeglobals hinzu: [QtQuickRendererSettings] RenderLoop=basic SceneGraphBackend=opengl

Fehler beim Speichern der Anmeldeinformationen (Schlüsselbund)

Wenn kDrive bei jedem Start Ihre Anmeldeinformationen anfordert oder einen Fehler Failed to save authentication info to keychain anzeigt:

• Stellen Sie sicher, dass ein Passwort-Manager (Gnome Keyring oder KWallet) installiert und entsperrt ist.
• Überprüfen Sie, ob der D-Bus-Dienst org.freedesktop.secrets konfiguriert ist. Wenn Sie KWallet verwenden, muss die Datei /usr/share/dbus-1/services/org.freedesktop.secrets.service Folgendes enthalten: [D-BUS-Dienst] Name=org.freedesktop.secrets Exec=/usr/bin/kwalletd5

Verwendung von AppImageLauncher

Wenn Sie AppImageLauncher verwenden und die Integration fehlschlägt, stellen Sie sicher, dass Sie eine Version verwenden, die höher oder gleich 3.0.0 (Beta 2) ist, um das Komprimierungsformat der kDrive-Datei zu unterstützen.

Fehlerbehebung bei anhaltenden Abstürzen

Wenn die Anwendung ohne Fehlermeldung abstürzt, können Sie einen Bericht zur Analyse erstellen, indem Sie die letzten Zeilen des Systemprotokolls extrahieren: 
journalctl -r -n 1000 > kdrive_syslog.txt