Ce guide détaille l'installation de l'app desktop kDrive Infomaniak sur un ordinateur possédant un système d'exploitation Linux. Elle vous permettra ensuite une synchronisation de vos fichiers de l'ordinateur avec kDrive.

Préambule

• Sur cet OS, certaines fonctionnalités de kDrive ne sont pas disponibles, comme l'option Lite Sync ou le menu contextuel au clic droit.
• L'application kDrive est officiellement supportée par Infomaniak uniquement sur les systèmes suivants :
  • Ubuntu 22.04 LTS (et suivantes)
  • Environnements de bureau : GNOME ou KDE
• L'application peut éventuellement fonctionner sur d'autres distributions Linux ou avec d'autres environnements de bureau ; cependant, Infomaniak ne fournit aucun support concernant l'installation ou l'exécution de l'application en dehors des configurations mentionnées ci-dessus.

Installation de kDrive sur Linux

Prérequis

• Télécharger l'app desktop kDrive pour Linux (fichier de type .AppImage)
• Fuse2 (requis pour exécuter une appimage):
  • Depuis la version 23.04 (et suivantes) de Ubuntu, après avoir double-cliqué sur le fichier AppImage, il ne se passera rien.
  • Les dernières versions d'Ubuntu utilisent en effet une version "trop" récente de FUSE (l'interface "Filesystem in User Space" sur laquelle les AppImages s'appuient pour fonctionner) pour laquelle les AppImages ne sont pas conçues.
  • Les AppImages ont besoin de FUSE v2 pour fonctionner: sudo apt install libfuse2
• D-Bus
• Gnome-keyring ou kwallet (en principe déjà présent sur votre machine sauf avec certaines distributions light)

Ensuite:

1. Placez le fichier dans un dossier nommé par exemple "Applications".
2. Faites un clic droit sur le fichier et choisir Permissions.
3. Cochez la case "Autoriser l'exécution du fichier comme un programme".

Afin que kDrive s'exécute au démarrage, ajoutez le fichier dans “Préférences des applications au démarrage” ou similaire.

Problèmes connus et solutions

Synchronisation bloquée ou erreur "Inotify watches"

Si la synchronisation semble figée (ex: étape 1/10) ou si les journaux (logs) indiquent l'erreur Out of memory or limit number of inotify watches reached!, cela signifie que la limite du système pour surveiller les dossiers est atteinte.

• Vérifier la limite actuelle : cat /proc/sys/fs/inotify/max_user_watches
• Augmenter la limite : pour doubler la valeur (ex: passer à 131072), exécutez : 
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf 
  Puis appliquez avec : sudo sysctl -p

L'application crash à l'ouverture (AppArmor / Wayland)

Sur certaines versions d'Ubuntu (24.04+) ou Debian, la sécurité AppArmor peut bloquer l'ouverture de la fenêtre de connexion.

• Solution AppArmor : installez les utilitaires : sudo apt install apparmor-utils. Créez ensuite le profil pour kDrive : sudo aa-autodep /chemin/vers/votre/kDrive.AppImage et redémarrez le service : sudo service apparmor restart.
• Conflit Wayland : si l'application crash spécifiquement sous Wayland, tentez de forcer l'utilisation de X11 en lançant l'application via le terminal avec la commande : 
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problèmes d'affichage de l'icône ou de la fenêtre

• Icône invisible (Gnome) : installez l'extension AppIndicator Support ; notez que l'extension Dash to Panel est connue pour rendre les menus de l'application invisibles et n'est pas recommandée.
• Fenêtre de synthèse impossible à ouvrir : vérifiez que les bibliothèques libfuse2 et libdbus-1-dev sont bien installées sur votre système.
• KDE Wayland : si l'interface ne s'affiche pas correctement, ajoutez ces lignes à votre fichier ~/.config/kdeglobals :[QtQuickRendererSettings] RenderLoop=basic SceneGraphBackend=opengl

Erreur de stockage des identifiants (Magasin de clés)

Si kDrive demande vos identifiants à chaque démarrage ou indique une erreur Failed to save authentication info to keychain :

• Assurez-vous qu'un gestionnaire de mots de passe (Gnome Keyring ou KWallet) est installé et déverrouillé.
• Vérifiez que le service D-Bus org.freedesktop.secrets est configuré. Si vous utilisez KWallet, le fichier /usr/share/dbus-1/services/org.freedesktop.secrets.service doit contenir :[D-BUS Service] Name=org.freedesktop.secrets Exec=/usr/bin/kwalletd5

Utilisation d'AppImageLauncher

Si vous utilisez AppImageLauncher et que l'intégration échoue, assurez-vous d'utiliser une version supérieure ou égale à la 3.0.0 (beta 2) pour supporter le format de compression du fichier kDrive.

Débogage en cas de crash persistant

Si l'application crash sans message d'erreur, vous pouvez générer un rapport pour analyse en extrayant les dernières lignes du journal système : 
journalctl -r -n 1000 > kdrive_syslog.txt