Ce guide détaille l'installation de l'application desktop kDrive d'Infomaniak sur un ordinateur équipé du système d'exploitation Linux. Cette application permet de synchroniser automatiquement les fichiers de votre ordinateur avec votre espace kDrive en ligne.

Préambule

• Sur cet OS, certaines fonctionnalités avancées de kDrive ne sont pas disponibles, comme l'option Lite Sync (qui permet de consulter vos fichiers sans les stocker physiquement sur le disque) ou le menu contextuel via le clic droit (pour partager un lien rapidement, par exemple).
• L'application kDrive est officiellement supportée par Infomaniak uniquement sur les configurations suivantes:
  • Ubuntu 22.04 LTS (et versions supérieures)
  • Environnements de bureau : GNOME ou KDE
• L'application peut fonctionner sur d'autres distributions Linux (Debian, Fedora, etc.) ou avec d'autres environnements de bureau, mais Infomaniak ne fournit aucune assistance technique pour l'installation ou l'utilisation en dehors des configurations mentionnées ci-dessus.

Installation de kDrive sur Linux

Prérequis

• Télécharger l'application kDrive pour Linux (il s'agit d'un fichier au format .AppImage).
• D-Bus (système de communication interne présent sur la majorité des versions).
• Gnome-keyring ou KWallet (gestionnaires de mots de passe généralement intégrés, sauf sur les versions de Linux très allégées).

Ensuite :

1. Placez le fichier téléchargé dans un dossier de votre choix, par exemple un dossier nommé "Applications" dans votre répertoire personnel.
2. Faites un clic droit sur le fichier, choisissez Propriétés puis l'onglet Permissions.
3. Cochez la case "Autoriser l'exécution du fichier comme un programme".

Afin que kDrive se lance automatiquement à l'allumage de votre ordinateur, ajoutez ce fichier dans vos "Préférences des applications au démarrage" (ou menu équivalent selon votre système).

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 indiquent l'erreur Out of memory or limit number of inotify watches reached!, cela signifie que votre système limite le nombre de fichiers qu'il peut surveiller simultanément.

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

L'application se ferme à l'ouverture (AppArmor / Wayland)

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

• Solution AppArmor : installez les outils nécessaires : sudo apt install apparmor-utils. Créez ensuite une règle pour kDrive : sudo aa-autodep /path/to/kDrive.AppImage et redémarrez le service : sudo service apparmor restart.
• Conflit Wayland : si l'application crash sous Wayland, tentez de forcer l'affichage classique (X11) en lançant l'application via le terminal avec la commande suivante :
  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 peut rendre les menus de l'application invisibles et n'est pas recommandée.
• Fenêtre impossible à ouvrir : vérifiez que les bibliothèques logicielles libfuse2 et libdbus-1-dev sont bien installées sur votre système.
• KDE Wayland : si l'interface s'affiche mal, ajoutez ces lignes à votre fichier de configuration ~/.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 l'erreur Failed to save authentication info to keychain :

• Assurez-vous qu'un gestionnaire de mots de passe (Gnome Keyring ou KWallet) est bien installé et qu'il est déverrouillé lors de l'ouverture de votre session.
• 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 l'outil AppImageLauncher et que l'intégration échoue, vérifiez que vous utilisez au minimum la version 3.0.0 (beta 2) pour supporter le format de compression de kDrive.

Aide au diagnostic en cas de crash

Si l'application se ferme sans message d'erreur, vous pouvez générer un rapport pour analyse technique en extrayant les dernières activités de votre système avec cette commande :
journalctl -r -n 1000 > kdrive_syslog.txt