man(1)

✨ onedriver ✨

okay so bestie, you're reading the man(1) page for onedriver — a native Linux client for Microsoft OneDrive. yes, the whole thing. grab a snack 🍓, we're doing this.

---

🌸 NAME 🌸

onedriver — a native Linux client for Microsoft OneDrive. that's it, that's the name, it's giving "does exactly what it says on the tin" energy 💅

---

🦋 SYNOPSIS 🦋

onedriver [OPTION] <mountpoint>

---

💜 DESCRIPTION 💜

so here's the vibe: this program mounts your OneDrive account as a Linux filesystem at whatever location you point at with mountpoint.

and no, bestie, it is not a sync client. not me explaining this for the third time 😭. files are fetched on-demand and cached locally — only the files you actually use get downloaded. your disk is safe, your bandwidth is safe, we're being efficient here, we're being iconic.

one thing though: while you're offline, the filesystem is read-only until connectivity comes back. so no creating stuff in airplane mode, sorry angel ✈️

---

🎀 OPTIONS 🎀

• -a, --auth-only — just authenticate to OneDrive and then dip. that's the whole job. bye 👋
• -f, --config-file — a YAML-formatted config file that onedriver uses. defaults to "~/.config/onedriver/config.yml" if you don't say otherwise.
• -c, --cache-dir dir — change the default cache directory. if the path doesn't already exist, it gets created for you (so thoughtful 💖). the dir argument says where it goes.
• -d, --debug — turn on FUSE debug logging. this logs all the chit-chat between onedriver and the kernel. it's giving surveillance but make it helpful 🔍
• -h, --help — displays a help message. the classic.
• -l, --log level — set how chatty the logging is. level can be one of: fatal, error, warn, info, debug or trace. default is debug, because we like details here 💅
• -n, --no-browser — disables launching the built-in web browser during authentication. instead you follow the instructions in the terminal to authenticate to OneDrive. terminal girlies rise up 🖥️✨
• -v, --version — display program version. short, sweet, informative.
• -w, --wipe-cache — delete the existing onedriver cache directory and then exit. this is equivalent to resetting the program. it's a full reset, bestie — everything local goes poof. 💀

---

🌈 SYSTEM INTEGRATION 🌈

ok so you want onedriver to just... start automatically? so you always have your files? slay. you can run onedriver as a systemd user service.

in this example, mountpoint refers to where we want OneDrive to be mounted at (for instance, ~/OneDrive). and the cute part: mounting OneDrive via systemd lets you mount multiple drives at the same time — as long as they use different mountpoints. multitasking queen 👑

⭐ Create the mountpoint and determine the service name

mkdir -p mountpoint
export SERVICE_NAME=$(systemd-escape --template onedriver@.service --path mountpoint)

⭐ Mount OneDrive

systemctl --user daemon-reload
systemctl --user start $SERVICE_NAME

⭐ Mount OneDrive on login

systemctl --user enable $SERVICE_NAME

⭐ Check onedriver's logs

journalctl --user -u $SERVICE_NAME

look at you go, fully automated, no cap 🫶

---

🙈 TROUBLESHOOTING 🙈

good news: most errors can be solved by simply restarting the program. onedriver is designed to recover cleanly from errors with no extra effort on your part. it heals, it moves on, main character energy fr fr.

but okay, real talk: it's possible there's a deadlock or segfault that hasn't been caught in testing. if that happens, the onedriver filesystem and subsequent ops may hang indefinitely — ops will hang while the kernel waits for the dead onedriver process to respond. when this happens, you can cleanly unmount the filesystem with:

fusermount3 -uz $MOUNTPOINT

and if you want to reset onedriver completely (wipe all local state), you can do so via:

onedriver -w

fresh start, clean slate, we love a glow-up 💅

---

💀 KNOWN ISSUES AND DISCLAIMER 💀

🌸 the thumbnail thing

many file browsers (like GNOME's Nautilus) will attempt to automatically download all files within a directory in order to create thumbnail images. it's somewhat annoying, yes, but it only needs to happen once — after the initial thumbnail images have been created, thumbnails will persist between filesystem restarts. so it's a one-time tax, and then you're free 🦋

🌸 the symlink thing (Microsoft's fault, not ours)

Microsoft does not support symbolic links (or anything remotely like them) on OneDrive. attempting to create symbolic links within the filesystem returns ENOSYS (function not implemented) — because the functionality hasn't been implemented... by Microsoft. read that again. it's not us, bestie 😭

similarly, Microsoft does not expose the OneDrive Recycle Bin APIs. so if you want to empty or restore the OneDrive Recycle Bin, you must do so through the OneDrive web UI. (onedriver uses the native system trash/restore functionality independently of the OneDrive Recycle Bin.)

🌸 the disclaimer

this project is still in active development and is provided AS IS. there are no guarantees.

It might kill your cat. 🐈💀

---

👑 SEE ALSO 👑

further information can be found at:

https://github.com/jstaf/onedriver

---

and that's the whole page, bestie 🫶 this was 0.15.0, from Jan 2026, and it's the man(1) page for onedriver. go mount something iconic ✨💖