OneDrive en Ubuntu: instalar y sincronizar paso a paso

Si usas Ubuntu y tus archivos están en OneDrive, te toparás enseguida con una realidad incómoda: Microsoft no ofrece un cliente oficial de OneDrive para Linux. Eso no significa que no puedas sincronizarlo. Existen varias alternativas de código abierto, maduras y mantenidas, que funcionan muy bien en Ubuntu 22.04 y 24.04. En esta guía comparamos las tres opciones principales, instalamos y configuramos paso a paso la más completa (un cliente de sincronización que funciona como servicio) y resolvemos los problemas habituales.

Las opciones para usar OneDrive en Ubuntu

Cliente onedrive (de abraunegg): un programa de línea de comandos, de código abierto, que sincroniza una carpeta local con tu OneDrive y puede ejecutarse como servicio en segundo plano. Soporta OneDrive personal, OneDrive para la empresa y bibliotecas de SharePoint. Es la opción más completa y la que seguiremos en esta guía.
OneDriver: monta tu OneDrive como una unidad y descarga los archivos solo cuando los abres (acceso «a demanda»), con una interfaz gráfica sencilla. Es la opción más parecida a la experiencia de Windows y ocupa poco disco.
rclone: una herramienta general de sincronización con la nube que, entre otros servicios, admite OneDrive. Es muy flexible y puede montar el almacenamiento como unidad o copiar y sincronizar carpetas desde scripts.
Acceso web: siempre puedes usar OneDrive desde el navegador, sin instalar nada, para un uso ocasional.

Si quieres tener tus archivos siempre disponibles sin conexión y sincronizados de forma automática, elige el cliente onedrive. Si tienes poco espacio en disco y prefieres descargar archivos solo cuando los necesites, valora OneDriver o rclone con montaje.

Paso 1: actualiza el sistema

sudo apt update && sudo apt upgrade -y

Si acabas de instalar Ubuntu y quieres dejarlo a punto antes de seguir, tienes una lista de primeros pasos en qué hacer después de instalar Ubuntu 24.04.

Paso 2: instala el cliente onedrive desde el repositorio del proyecto

Aunque Ubuntu incluye un paquete onedrive en sus repositorios, la documentación del propio proyecto desaconseja instalarlo: esa versión suele estar desactualizada, sin soporte y con errores ya corregidos. Para Ubuntu 22.04 y 24.04, el proyecto recomienda su repositorio en el servicio de compilación de openSUSE. Estos son los comandos, que sirven para ambas versiones porque la variable toma la de tu sistema:

UBUNTU=$(lsb_release -rs)    # devuelve 22.04 o 24.04
wget -qO - "https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_${UBUNTU}/Release.key" | gpg --dearmor | sudo tee /usr/share/keyrings/obs-onedrive.gpg > /dev/null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/obs-onedrive.gpg] https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_${UBUNTU}/ ./" | sudo tee /etc/apt/sources.list.d/onedrive.list
sudo apt update
sudo apt install --no-install-recommends --no-install-suggests onedrive
onedrive --version

Los dos primeros comandos añaden la clave de firma y el repositorio del proyecto; el último instala el cliente sin paquetes opcionales. Comprueba siempre estas instrucciones en la página del proyecto en GitHub, porque la dirección del repositorio puede cambiar con el tiempo. Si en el futuro actualizas Ubuntu a otra versión, repite el proceso con la versión nueva.

Paso 3: autoriza el cliente con tu cuenta de Microsoft

Ejecuta el programa sin opciones en una terminal:

onedrive

La primera vez te mostrará una dirección web larga para autorizar la aplicación. El proceso es el siguiente:

Copia la dirección que aparece en la terminal y ábrela en el navegador.
Inicia sesión con tu cuenta de Microsoft y acepta los permisos.
El navegador te llevará a una página en blanco: es lo esperado. Copia la dirección completa de esa página en blanco (empieza por https://login.microsoftonline.com/common/oauth2/nativeclient?code=...).
Pégala en la terminal, donde el programa la está esperando, y pulsa Intro.

Si todo va bien, verás un mensaje de que la autorización se ha completado y se guardará el acceso en ~/.config/onedrive/. No compartas esa carpeta ni su contenido: contiene las credenciales de acceso a tus archivos.

Paso 4: primera sincronización (con una prueba previa)

Antes de descargar todo, haz una simulación para ver qué hará el programa:

onedrive --synchronize --dry-run    # simula, sin cambiar nada
onedrive --synchronize              # sincroniza de verdad

Por defecto, el programa crea una carpeta ~/OneDrive y descarga en ella todo el contenido de tu OneDrive. Si tienes cientos de gigas en la nube y poco espacio en el disco, no ejecutes la sincronización completa: configura primero la sincronización selectiva (paso 6).

Paso 5: sincronización automática en segundo plano

Para que la sincronización sea continua, ejecuta el cliente como servicio de usuario con systemd:

systemctl --user enable onedrive
systemctl --user start onedrive
systemctl --user status onedrive

# Para que siga funcionando aunque cierres la sesión
sudo loginctl enable-linger "$USER"

# Ver los registros del servicio
journalctl --user -u onedrive -f

En modo servicio, el cliente vigila los cambios en la carpeta local y los sube, y comprueba cada cierto tiempo los cambios en la nube. Si prefieres ejecutarlo manualmente en una terminal, puedes lanzar onedrive --monitor.

Paso 6: configura qué se sincroniza

La configuración vive en ~/.config/onedrive/config. Si no existe, el programa funciona con los valores por defecto, y puedes copiar la plantilla de ejemplo que se instala con el paquete (/usr/share/doc/onedrive/config). Algunas opciones útiles:

# ~/.config/onedrive/config
sync_dir = "~/OneDrive"
# Archivos que no se sincronizan (temporales, etc.)
skip_file = "~*|.~*|*.tmp|*.partial"
# Carpetas que no se sincronizan
skip_dir = "node_modules|.cache"

Para sincronizar solo algunas carpetas, crea el archivo ~/.config/onedrive/sync_list con una ruta por línea, relativa a la raíz de tu OneDrive:

/Documentos
/Fotos/2025
!/Documentos/Pesados

Cada línea indica una carpeta que se incluye; las que empiezan por ! se excluyen. Cada vez que cambies esta lista o la configuración de la sincronización, ejecuta una vez onedrive --synchronize --resync para que el programa vuelva a evaluar todo, y haz antes un --dry-run para comprobar el resultado.

OneDrive para la empresa y SharePoint

El cliente soporta cuentas de trabajo y bibliotecas de SharePoint. Para las bibliotecas, necesitarás el identificador de la unidad (drive_id), que el programa puede ayudarte a obtener con sus opciones de consulta, y una configuración independiente por cada una de ellas (cada biblioteca se ejecuta con su propio directorio de configuración, mediante --confdir). Es un uso más avanzado: consulta la documentación del proyecto, porque depende de cómo esté configurada la organización.

Alternativa: rclone para montar OneDrive como una unidad

Si prefieres no descargar los archivos, rclone puede montar tu OneDrive como si fuera un disco:

sudo apt install rclone fuse3 -y
rclone config            # crea un "remote" nuevo de tipo onedrive y sigue el asistente
mkdir -p ~/OneDrive-montado
rclone mount onedrive: ~/OneDrive-montado --vfs-cache-mode full --daemon

# Desmontar
fusermount3 -u ~/OneDrive-montado

Con --vfs-cache-mode full los archivos se almacenan temporalmente en una caché local mientras trabajas con ellos, lo que mejora la compatibilidad con las aplicaciones. rclone también permite copiar o sincronizar carpetas desde scripts (rclone copy, rclone sync); ten cuidado con sync, porque borra en el destino lo que no existe en el origen. Si quieres automatizar copias periódicas, puedes lanzarlas con cron.

Problemas frecuentes y soluciones

La autorización falla o aparece «invalid_grant»: el código de la dirección caduca en pocos minutos y solo sirve una vez. Repite el proceso desde cero con onedrive --logout y vuelve a ejecutarlo, y pega la dirección completa de la página en blanco sin recortarla.
Errores de conexión o de certificado: comprueba que el equipo tiene la hora y la fecha correctas (timedatectl) y que puedes llegar a login.microsoftonline.com.
Aparece «Skipping» o archivos que no se sincronizan: revisa skip_file y skip_dir. También hay nombres que OneDrive no admite (caracteres como : o *, o nombres que terminan en punto o espacio).
En modo servicio no detecta cambios: el sistema puede haber llegado al límite de vigilancia de archivos. Auméntalo con echo 'fs.inotify.max_user_watches=524288' | sudo tee /etc/sysctl.d/99-inotify.conf y sudo sysctl --system.
La carpeta ocupa demasiado: usa la sincronización selectiva del paso 6 y excluye las carpetas grandes.
Archivos duplicados con sufijos de nombre del equipo: son conflictos, es decir, el mismo archivo modificado en dos sitios a la vez. Revísalos y conserva la versión buena.

Buenas prácticas

Haz una primera prueba con una carpeta pequeña antes de sincronizar todo tu OneDrive.
No trabajes con una misma carpeta desde dos clientes distintos de sincronización a la vez: provoca conflictos.
OneDrive no es una copia de seguridad: si borras un archivo localmente, se borra también en la nube (aunque tengas la papelera). Mantén copias de lo importante en otro lugar.
Protege tu cuenta con verificación en dos pasos y una contraseña única; tienes recomendaciones en nuestra guía para crear contraseñas seguras.
Si vas a tratar con muchos archivos desde la terminal, repasa los comandos básicos de la terminal de Linux.

Cómo desinstalar

systemctl --user disable --now onedrive
onedrive --logout
sudo apt remove onedrive -y
# Opcional: eliminar la configuración y las credenciales
rm -rf ~/.config/onedrive

Esto no borra tus archivos de OneDrive en la nube ni la carpeta local ~/OneDrive.

Preguntas frecuentes

¿Existe un cliente oficial de OneDrive para Linux?

No. Microsoft ofrece clientes para Windows, macOS, Android e iOS, pero no para Linux. Las opciones de esta guía son proyectos independientes de la comunidad.

¿Es seguro usar estos clientes?

Son de código abierto y usan la interfaz oficial de Microsoft (la API de OneDrive) con tu autorización, de manera que no ven tu contraseña. Aun así, instálalos solo desde el repositorio que indica el propio proyecto (o desde su página oficial) y protege la carpeta de configuración.

¿Funciona la sincronización «a demanda» como en Windows?

El cliente onedrive descarga los archivos de las carpetas que sincroniza. Para un comportamiento a demanda, usa OneDriver o el montaje de rclone.

Conclusión

Aunque Microsoft no ofrezca un cliente de OneDrive para Linux, en Ubuntu tienes buenas alternativas. Para sincronizar de forma automática, instala el cliente onedrive, autorízalo con tu cuenta, prueba con --dry-run, configura qué carpetas quieres y déjalo funcionando como servicio de usuario. Si prefieres no ocupar disco, monta tu OneDrive con rclone o usa OneDriver.

Cómo instalar OneDrive en Ubuntu y sincronizar tus archivos