Command-line reference

Log in through Nextcloud’s Login Flow v2 and store the credentials. Prints a URL to confirm in a browser; your real account password is never seen or stored. Nothing is mounted.

Mount the filesystem in the foreground. Requires a binary built with the fuse feature; the distribution packages are.

Two accounts may not share or nest a mountpoint; mount refuses to start where its target equals, contains, or sits inside another active mount.

Manage the systemd user service for this account. Linux only.

On a machine where the package installed the unit template, systemctl --user enable --now wusel@<account> does the same thing.

Keep a file or directory offline permanently. Downloads it now — a directory recursively — and exempts it from cache eviction.

A directory pin covers its whole subtree, including entries not yet listed. Needs no running mount.

Remove a pin. The files become ordinary, evictable cache again; nothing is deleted from the server. Omitting PATH removes the whole-account pin.

Fetch the current version of pinned files whose local copy has gone out of date, in place. Omitting PATH updates every pin in the account.

Deliberately not the same as unpinning and pinning again, which would drop the eviction marker first — a re-download that then failed would leave the file both outdated and unprotected.

List the account’s pins.

List the configured accounts. Identical to wusel account list.

Show what the mount is doing right now, by file name: uploads still owed to the server — including any parked after a permanent failure — files coming down, and the rest of the work in flight.

This is for the person whose files these are. doctor is the other half: name-free, and made to be shared.

Collect diagnostics for a support case: system, daemon, mount, the FUSE connection’s waiting count, the daemon’s internal state, and a redacted journal tail. Redacted by default, so the output is safe to attach to a ticket.

Drop cached data so the next access loads fresh from the server. Stop a running mount first.

Separates a stale-cache problem from a server-side one. It refuses to run while the account is mounted; see Known limitations for why.

Send a test notification through the real backend, to verify the desktop’s notification channel works independently of any sync event.

Install this account’s file-manager cloud-provider registration, so a file manager shows the mount in its sidebar. Writes into a system directory, so it needs root — the file manager’s collector only scans system data directories, never the user’s home.

The packages do this for the default account already. Named accounts need it run once each.

Remove this account’s registration. Takes the same --dir DIR.

Run the GNOME Shell search provider — a D-Bus service that GNOME Shell activates on demand and that answers from the server’s Unified Search. Not something to start by hand; it is listed here because it is a real subcommand and will appear in process listings.