Questa guida illustra l'installazione dell'applicazione desktop kDrive di Infomaniak su un computer dotato del sistema operativo Linux. Questa applicazione consente di sincronizzare automaticamente i file del computer con lo spazio kDrive online.

Introduzione

• Su questo sistema operativo, alcune funzionalità avanzate di kDrive non sono disponibili, come l'opzione Lite Sync (che consente di visualizzare i file senza memorizzarli fisicamente sul disco) o il menu contestuale tramite il clic destro (per condividere rapidamente un link, 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 assistenza tecnica per l'installazione o l'utilizzo al di fuori delle configurazioni menzionate sopra.

Installazione di kDrive su Linux

Prerequisiti

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

Successivamente:

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

Per far sì che kDrive si avvii automaticamente all'accensione del computer, aggiungi questo file alle tue "Impostazioni di avvio" (o al menu equivalente, a seconda del sistema operativo).

Problemi noti e soluzioni

Sincronizzazione bloccata o errore "Inotify watches"

Se la sincronizzazione sembra essere bloccata (ad esempio, fase 1/10) o se i log indicano l'errore Memoria insufficiente o numero massimo di "inotify watches" raggiunto!, significa che il sistema limita il numero di file che può monitorare contemporaneamente.

• Verificare il limite attuale: digitare il comando cat /proc/sys/fs/inotify/max_user_watches in un terminale.
• Aumentare il limite: per raddoppiare il valore (ad esempio, portandolo a 131072), eseguire:
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf
  Quindi applicare la modifica con: sudo sysctl -p

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

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

• Soluzione AppArmor: installare gli strumenti necessari: sudo apt install apparmor-utils. Creare quindi una regola per kDrive: sudo aa-autodep /path/to/kDrive.AppImage e riavviare il servizio: sudo service apparmor restart.
• Conflitto Wayland: se l'applicazione si blocca con Wayland, provare a forzare l'utilizzo dell'interfaccia grafica 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. Tieni presente che l'estensione Dash to Panel potrebbe rendere i menu dell'applicazione invisibili e non è consigliata.
• Finestra impossibile da aprire: verificare che le librerie software libfuse2 e libdbus-1-dev siano correttamente installate sul sistema.
• KDE Wayland: se l'interfaccia non viene visualizzata correttamente, aggiungere le seguenti righe al file di configurazione ~/.config/kdeglobals:
  [QtQuickRendererSettings]
RenderLoop=basic
SceneGraphBackend=opengl

Errore nel salvataggio delle credenziali (portachiavi)

Se kDrive richiede le credenziali ogni volta che viene avviato o indica l'errore Impossibile salvare le informazioni di autenticazione nel portachiavi:

• Assicurati che sia installato un gestore di password (Gnome Keyring o KWallet) e che sia sbloccato all'apertura della 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 non riesce, verifica di utilizzare almeno la versione 3.0.0 (beta 2) per supportare il formato di compressione di kDrive.

Assistenza per la diagnosi in caso di blocco

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