Questa guida dettaglia l'installazione dell'applicazione desktop kDrive di Infomaniak su un computer equipaggiato con il sistema operativo Linux. Questa applicazione permette di sincronizzare automaticamente i file del tuo computer con il tuo spazio kDrive online.

Premessa

• Su questo sistema operativo, alcune funzionalità avanzate di kDrive non sono disponibili, come l'opzione Lite Sync (che permette di consultare i tuoi file senza memorizzarli fisicamente sul disco) o il menu contestuale tramite il tasto destro (per condividere un link rapidamente, ad esempio).
• L'applicazione kDrive è ufficialmente supportata da Infomaniak solo sulle seguenti configurazioni:
  • Ubuntu 22.04 LTS (e versioni successive)
  • Ambienti desktop: GNOME o KDE
• L'applicazione può funzionare su altre distribuzioni Linux (Debian, Fedora, ecc.) o con altri ambienti desktop, ma Infomaniak non fornisce alcuna assistenza tecnica per l'installazione o l'uso al di fuori delle configurazioni menzionate sopra.

Installazione di kDrive su Linux

Prerequisiti

• Scaricare l'applicazione kDrive per Linux (si tratta di un file in formato .AppImage).
• D-Bus (sistema di comunicazione interno presente sulla maggior parte delle versioni).
• Gnome-keyring o KWallet (gestori di password generalmente integrati, tranne che nelle versioni di Linux molto leggere).

Successivamente:

1. Posiziona il file scaricato in una cartella a tua scelta, ad esempio una cartella chiamata "Applicazioni" nella tua directory personale.
2. Fai un clic destro sul file, scegli Proprietà poi la scheda Permessi.
3. Spunta la casella "Consenti l'esecuzione del file come programma".

Per far sì che kDrive si avvii automaticamente all'accensione del tuo computer, aggiungi questo file nelle tuePreferenze delle applicazioni all'avvio (o menu equivalente a seconda del tuo sistema).

Problemi noti e soluzioni

Sincronizzazione bloccata o errore "Inotify watches"

Se la sincronizzazione sembra bloccata (ad esempio: fase 1/10) o se i registri indicano l'errore Out of memory or limit number of inotify watches reached!, ciò significa che il tuo sistema limita il numero di file che può monitorare contemporaneamente.

• Verificare il limite attuale: digita il comando cat /proc/sys/fs/inotify/max_user_watches in un terminale.
• Aumentare 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 la modifica con: sudo sysctl -p

L'applicazione si chiude all'apertura (AppArmor / Wayland)

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

• Soluzione AppArmor: installa gli strumenti necessari: sudo apt install apparmor-utils. Crea quindi una regola per kDrive: sudo aa-autodep /path/to/kDrive.AppImage e riavvia il servizio: sudo service apparmor restart.
• Conflitto Wayland: se l'applicazione si blocca sotto Wayland, prova a forzare la visualizzazione classica (X11) avviando l'applicazione tramite il terminale con il seguente 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 può rendere invisibili i menu dell'applicazione e non è consigliata.
• Finestra impossibile da aprire: verifica che le librerie software libfuse2 e libdbus-1-dev siano installate correttamente sul tuo sistema.
• KDE Wayland: se l'interfaccia si visualizza male, aggiungi queste righe al tuo file di configurazione ~/.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 l'errore Failed to save authentication info to keychain:

• Assicurati che un gestore di password (Gnome Keyring o KWallet) sia installato e sbloccato all'apertura della tua sessione.
• Verifica che il servizio D-Bus org.freedesktop.secrets sia configurato. Se utilizzi KWallet, il file /usr/share/dbus-1/services/org.freedesktop.secrets.service deve contenere:
  [D-BUS Service]
Name=org.freedesktop.secrets
Exec=/usr/bin/kwalletd5

Utilizzo di AppImageLauncher

Se utilizzi lo strumento AppImageLauncher e l'integrazione fallisce, verifica di utilizzare almeno la versione 3.0.0 (beta 2) per supportare il formato di compressione di kDrive.

Assistenza alla diagnosi in caso di crash

Se l'applicazione si chiude senza messaggio di errore, puoi generare un rapporto per l'analisi tecnica estraendo le ultime attività del tuo sistema con questo comando:
journalctl -r -n 1000 > kdrive_syslog.txt