Questa guida dettaglia l'installazione dell'app desktop kDrive Infomaniak su un computer con sistema operativo Linux. Vi permetterà poi di sincronizzare i vostri file del computer con kDrive.

Premessa

• Su questo sistema operativo, alcune funzionalità di kDrive non sono disponibili, come l'opzione Lite Sync o il menu contestuale al clic destro.
• L'applicazione kDrive è ufficialmente supportata da Infomaniak solo sui seguenti sistemi:
  • Ubuntu 22.04 LTS (e successive)
  • Ambienti desktop: GNOME o KDE
• L'applicazione potrebbe eventualmente funzionare su altre distribuzioni Linux o con altri ambienti desktop; tuttavia, Infomaniak non fornisce alcun supporto per l'installazione o l'esecuzione dell'applicazione al di fuori delle configurazioni menzionate sopra.

Installazione di kDrive su Linux

Prerequisiti

• Scaricare l'app desktop kDrive per Linux (file di tipo .AppImage)
• Fuse2 (necessario per eseguire una appimage):
  • Dalla versione 23.04 (e successive) di Ubuntu, dopo aver fatto doppio clic sul file AppImage, non accadrà nulla.
  • Le ultime versioni di Ubuntu utilizzano infatti una versione "troppo" recente di FUSE (l'interfaccia "Filesystem in User Space" su cui si basano le AppImages per funzionare) per cui le AppImages non sono progettate.
  • Le AppImages necessitano di FUSE v2 per funzionare: sudo apt install libfuse2
• D-Bus
• Gnome-keyring o kwallet (in linea di principio già presente sulla vostra macchina tranne con alcune distribuzioni light)

Successivamente:

1. Posizionate il file in una cartella denominata ad esempio "Applicazioni".
2. Fate un clic destro sul file e scegliete Permessi.
3. Seleziona la casella "Autorizza l'esecuzione del file come programma".

Per far sì che kDrive si avvii all'accensione, aggiungi il file in “Preferenze delle applicazioni di avvio” o simile.

Problemi noti e soluzioni

Sincronizzazione bloccata o errore "Inotify watches"

Se la sincronizzazione sembra bloccata (ad esempio, fase 1/10) o se i registri (log) indicano l'errore Out of memory or limit number of inotify watches reached!, ciò significa che il limite del sistema per monitorare le cartelle è stato raggiunto.

• Verifica il limite attuale: cat /proc/sys/fs/inotify/max_user_watches
• Aumenta il limite: per raddoppiare il valore (ad esempio, passare a 131072), esegui: 
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf 
  Poi applica con: sudo sysctl -p

L'applicazione si blocca all'avvio (AppArmor / Wayland)

Su alcune versioni di Ubuntu (24.04+) o Debian, la sicurezza AppArmor può bloccare l'apertura della finestra di accesso.

• Soluzione AppArmor: installa gli strumenti: sudo apt install apparmor-utils. Crea quindi il profilo per kDrive: sudo aa-autodep /percorso/verso/kDrive.AppImage e riavvia il servizio: sudo service apparmor restart.
• Conflitto Wayland: se l'applicazione si blocca specificamente sotto Wayland, prova a forzare l'uso di X11 avviando l'applicazione tramite il terminale con il comando: 
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problemi di visualizzazione dell'icona o della finestra

• Icona invisibile (Gnome): installa l'estensione AppIndicator Support; nota che l'estensione Dash to Panel è nota per rendere invisibili i menu dell'applicazione e non è consigliata.
• Finestra di sintesi impossibile da aprire: verifica che le librerie libfuse2 e libdbus-1-dev siano installate correttamente sul tuo sistema.
• KDE Wayland: se l'interfaccia non viene visualizzata correttamente, aggiungi queste righe al tuo file ~/.config/kdeglobals: [QtQuickRendererSettings] RenderLoop=basic SceneGraphBackend=opengl

Errore di memorizzazione delle credenziali (Magazzino chiavi)

Se kDrive richiede le tue credenziali ad ogni avvio o indica un errore Failed to save authentication info to keychain:

• Assicurati che un gestore di password (Gnome Keyring o KWallet) sia installato e sbloccato.
• Verificare che il servizio D-Bus org.freedesktop.secrets sia configurato. Se si utilizza KWallet, il file /usr/share/dbus-1/services/org.freedesktop.secrets.service deve contenere: [D-BUS Service]\nName=org.freedesktop.secrets\nExec=/usr/bin/kwalletd5

Utilizzo di AppImageLauncher

Se si utilizza AppImageLauncher e l'integrazione fallisce, assicurarsi di utilizzare una versione superiore o uguale alla 3.0.0 (beta 2) per supportare il formato di compressione del file kDrive.

Debug in caso di crash persistente

Se l'applicazione si blocca senza messaggio di errore, è possibile generare un rapporto per l'analisi estraendo le ultime righe del registro di sistema: \xa0
journalctl -r -n 1000 > kdrive_syslog.txt