Deze handleiding beschrijft de installatie van de desktop-applicatie kDrive van Infomaniak op een computer met het besturingssysteem Linux. Met deze applicatie kunt u de bestanden op uw computer automatisch synchroniseren met uw kDrive-opslag in de cloud.

Inleiding

• Op dit besturingssysteem zijn bepaalde geavanceerde functies van kDrive niet beschikbaar, zoals de optie Lite Sync (hiermee kunt u uw bestanden bekijken zonder ze fysiek op de schijf op te slaan) of het contextmenu via een rechtermuisklik (bijvoorbeeld om snel een link te delen).
• De kDrive-applicatie wordt door Infomaniak alleen officieel ondersteund op de volgende configuraties:
  • Ubuntu 22.04 LTS (en latere versies)
  • Desktopomgevingen: GNOME of KDE
• De applicatie kan mogelijk werken op andere Linux-distributies (Debian, Fedora, enz.) of met andere desktopomgevingen, maar Infomaniak biedt geen technische ondersteuning voor de installatie of het gebruik buiten de hierboven genoemde configuraties..

kDrive installeren op Linux

Vereisten

• Download de kDrive-app voor Linux (dit is een bestand in .AppImage-formaat).
• D-Bus (een intern communicatiesysteem dat aanwezig is in de meeste versies).
• Gnome-keyring of KWallet (wachtwoordbeheerders die meestal standaard zijn geïnstalleerd, behalve op zeer minimalistische Linux-versies).

Vervolgens:

1. Plaats het gedownloade bestand in een map naar keuze, bijvoorbeeld een map met de naam "Applicaties" in uw persoonlijke map.
2. Klik met de rechtermuisknop op het bestand, kies Eigenschappen en vervolgens het tabblad Rechten.
3. Vink het vakje "Sta toe dat het bestand als een programma wordt uitgevoerd".

Om ervoor te zorgen dat kDrive automatisch wordt gestart wanneer u uw computer inschakelt, voegt u dit bestand toe aan uw "Opstartprogramma's" (of het equivalente menu, afhankelijk van uw besturingssysteem).

Bekende problemen en oplossingen

Synchronisatie vastgelopen of foutmelding "Inotify watches"

Als de synchronisatie lijkt vast te lopen (bijvoorbeeld bij stap 1/10) of als de logbestanden de foutmelding Onvoldoende geheugen of het maximale aantal inotify watches is bereikt! weergeven, betekent dit dat uw systeem het aantal bestanden dat het tegelijkertijd kan volgen, beperkt.

• Controleer de huidige limiet: typ de opdracht cat /proc/sys/fs/inotify/max_user_watches in een terminal.
• Verhoog de limiet: om de waarde te verdubbelen (bijvoorbeeld naar 131072), voert u het volgende uit:
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf
  Pas vervolgens de wijziging toe met: sudo sysctl -p

De applicatie sluit af bij het openen (AppArmor / Wayland)

Op sommige recente versies van Ubuntu (24.04+) of Debian kan de beveiliging AppArmor voorkomen dat het inlogvenster wordt geopend.

• AppArmor-oplossing: installeer de benodigde tools: sudo apt install apparmor-utils. Maak vervolgens een regel voor kDrive: sudo aa-autodep /path/to/kDrive.AppImage en start de service opnieuw: sudo service apparmor restart.
• Wayland-conflict: als de applicatie onder Wayland vastloopt, probeer dan de klassieke weergave (X11) te forceren door de applicatie via de terminal te starten met het volgende commando:
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problemen met de weergave van het pictogram of het venster

• Pictogram is onzichtbaar (Gnome): installeer de extensie AppIndicator Support. Houd er rekening mee dat de extensie Dash to Panel ervoor kan zorgen dat de menu's van de applicatie onzichtbaar worden en wordt daarom niet aanbevolen.
• Venster kan niet worden geopend: controleer of de softwarebibliotheken libfuse2 en libdbus-1-dev correct op uw systeem zijn geïnstalleerd.
• KDE Wayland: als de interface niet correct wordt weergegeven, voeg dan de volgende regels toe aan uw configuratiebestand ~/.config/kdeglobals: 
  [QtQuickRendererSettings] 
RenderLoop=basic 
SceneGraphBackend=opengl

Fout bij het opslaan van inloggegevens (sleutelopslag)

Als kDrive bij elke keer opstarten om uw inloggegevens vraagt of de foutmelding Kon de authenticatiegegevens niet opslaan in de sleutelopslag weergeeft:

• Zorg ervoor dat een wachtwoordbeheerder (Gnome Keyring of KWallet) is geïnstalleerd en dat deze is ontgrendeld wanneer u uw sessie opent.
• Controleer of de D-Bus-service org.freedesktop.secrets is geconfigureerd. Als u KWallet gebruikt, moet het bestand /usr/share/dbus-1/services/org.freedesktop.secrets.service het volgende bevatten:
  [D-BUS Service]
Name=org.freedesktop.secrets
Exec=/usr/bin/kwalletd5

Gebruik van AppImageLauncher

Als u het hulpprogramma AppImageLauncher gebruikt en de integratie mislukt, controleer dan of u minimaal versie 3.0.0 (beta 2) gebruikt, zodat het compressieformaat van kDrive wordt ondersteund.

Hulp bij het diagnosticeren van een crash

Als de applicatie zonder foutmelding afsluit, kunt u een rapport genereren voor technische analyse door de meest recente activiteiten van uw systeem op te slaan met dit commando:
journalctl -r -n 1000 > kdrive_syslog.txt