Esta guía detalla la instalación de la aplicación de escritorio kDrive de Infomaniak en una computadora equipada con el sistema operativo Linux. Esta aplicación permite sincronizar automáticamente los archivos de su computadora con su espacio kDrive en línea.

Prólogo

• En este sistema operativo, algunas funcionalidades avanzadas de kDrive no están disponibles, como la opción Lite Sync (que permite consultar sus archivos sin almacenarlos físicamente en el disco) o el menú contextual mediante el clic derecho (para compartir un enlace rápidamente, por ejemplo).
• La aplicación kDrive es oficialmente soportada por Infomaniak únicamente en las siguientes configuraciones:
  • Ubuntu 22.04 LTS (y versiones superiores)
  • Entornos de escritorio: GNOME o KDE
• La aplicación puede funcionar en otras distribuciones Linux (Debian, Fedora, etc.) o con otros entornos de escritorio, pero Infomaniak no proporciona ninguna asistencia técnica para la instalación o el uso fuera de las configuraciones mencionadas anteriormente.

Instalación de kDrive en Linux

Requisitos previos

• Descargar la aplicación kDrive para Linux (se trata de un archivo en formato .AppImage).
• D-Bus (sistema de comunicación interna presente en la mayoría de las versiones).
• Gnome-keyring o KWallet (gestores de contraseñas generalmente integrados, excepto en las versiones de Linux muy ligeras).

A continuación:

1. Coloque el archivo descargado en una carpeta de su elección, por ejemplo, una carpeta llamada "Aplicaciones" en su directorio personal.
2. Haga clic derecho en el archivo, elija Propiedades y luego la pestaña Permisos.
3. Marque la casilla "Permitir la ejecución del archivo como un programa".

Para que kDrive se inicie automáticamente al encender su computadora, agregue este archivo en susPreferencias de aplicaciones de inicio(o menú equivalente según su sistema).

Problemas conocidos y soluciones

Sincronización bloqueada o error "Inotify watches"

Si la sincronización parece estar atascada (por ejemplo, en el paso 1/10) o si los registros indican el error Out of memory or limit number of inotify watches reached!, esto significa que su sistema limita el número de archivos que puede supervisar simultáneamente.

• Verificar el límite actual: escriba el comando cat /proc/sys/fs/inotify/max_user_watches en una terminal.
• Aumentar el límite: para duplicar el valor (por ejemplo, pasar a 131072), ejecute:
  echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf
  Luego aplique el cambio con: sudo sysctl -p

La aplicación se cierra al abrirse (AppArmor / Wayland)

En algunas versiones recientes de Ubuntu (24.04+) o Debian, la seguridad AppArmor puede bloquear la apertura de la ventana de inicio de sesión.

• Solución AppArmor: instale las herramientas necesarias: sudo apt install apparmor-utils. Luego cree una regla para kDrive: sudo aa-autodep /path/to/kDrive.AppImage y reinicie el servicio: sudo service apparmor restart.
• Conflicto Wayland: si la aplicación se bloquea bajo Wayland, intente forzar la visualización clásica (X11) ejecutando la aplicación desde el terminal con el siguiente comando:
  export QT_QPA_PLATFORM=xcb && ./kDrive.AppImage

Problemas de visualización del icono o la ventana

• Icono invisible (Gnome): instale la extensión AppIndicator Support. Tenga en cuenta que la extensión Dash to Panel puede hacer que los menús de la aplicación sean invisibles y no se recomienda.
• Ventana imposible de abrir: verifique que las bibliotecas libfuse2 y libdbus-1-dev estén instaladas en su sistema.
• KDE Wayland: si la interfaz se muestra mal, agregue estas líneas a su archivo de configuración ~/.config/kdeglobals:
  [QtQuickRendererSettings]
RenderLoop=basic
SceneGraphBackend=opengl

Error al almacenar las credenciales (Almacén de claves)

Si kDrive solicita sus credenciales cada vez que se inicia o indica el error Failed to save authentication info to keychain:

• Asegúrese de que un administrador de contraseñas (Gnome Keyring o KWallet) esté instalado y desbloqueado al iniciar su sesión.
• Verifique que el servicio D-Bus org.freedesktop.secrets esté configurado. Si usa KWallet, el archivo /usr/share/dbus-1/services/org.freedesktop.secrets.service debe contener:
  [D-BUS Service]
Name=org.freedesktop.secrets
Exec=/usr/bin/kwalletd5

Uso de AppImageLauncher

Si usa la herramienta AppImageLauncher y la integración falla, verifique que use al menos la versión 3.0.0 (beta 2) para soportar el formato de compresión de kDrive.

Ayuda para el diagnóstico en caso de fallo

Si la aplicación se cierra sin mensaje de error, puede generar un informe para análisis técnico extrayendo las últimas actividades de su sistema con este comando:
journalctl -r -n 1000 > kdrive_syslog.txt