Gets past your gateway.
Lands in your Finder.

NAS Drive mounts the Nextcloud on your own NAS as a real macOS location — even when it sits behind Cloudflare Access or an SSO proxy. It clears the gateway in your own browser, keeps the Nextcloud sign-in isolated in its own, then gets out of the way. No second app. No second copy of your data anywhere.

NAS Drive
Favourites
Documents
Downloads
Locations
NAS Drive
Network
DocumentsCloud only
PhotosAlways keep
Q3 Proposal.docxDownloaded
site-backup.tar.gzDownloading
Invoice-2148.pdfCloud only
Security CameraCloud only
Why this exists

Self-hosting your files shouldn't cost you your file manager.

You already run Nextcloud on a NAS. Three things usually stand between that and using it like an ordinary drive.

The browser tab problem

Your own files sit behind a login page. Opening a document means finding the tab, then downloading, then remembering to upload it back.

The whole-account problem

Classic sync clients want a full local mirror. A 6 TB array does not fit on a laptop, and you shouldn’t have to choose which folders you’re allowed to see.

The one NAS Drive was built for

The gateway problem

Put Cloudflare Access or an SSO proxy in front of Nextcloud and most clients break — the browser signs in fine while background requests quietly get a login page instead of files.

The primary feature

It signs in through the thing in front of your server.

NAS Drive treats the gateway as a first-class step and uses two different browsers to clear it: your real one for the ceremony that needs your passkeys, and its own isolated one for the Nextcloud approval that must never inherit a session.

How NAS Drive clears a gateway Your Mac Finder / WebDAV gateway device Edge gateway Cloudflare Access reverse proxy / OIDC Nextcloud on your NAS Safari - your default browser Your own browser profile passkey / Touch ID / saved logins NAS Drive receives only a code nothing about the ceremony is seen NAS Drive - isolated window Nextcloud Login Flow v2 fresh session / no inherited sign-in destroyed on every outcome 207 Multi-Status - files, not a login page
Step 1 of 6

A background request goes out for your file list. The gateway answers first, and it does not answer with files.

Surface 1 — your real browser

Because passkeys don't exist inside an app window

An embedded web view is not your browser profile. Your platform authenticator, Touch ID enrolment and saved passkeys are simply absent from it, so an identity provider offering WebAuthn falls back to a password typed into a window an app drew. The gateway step goes to the real thing.

  • The button names the browser — “Continue in Safari”, not “Continue in browser”
  • Whatever you set as default is what opens; changing it changes this with no update
  • NAS Drive gets an authorization code back and nothing else
  • If the system refuses to open it, you're told — not left waiting
Surface 2 — the isolated window

Because the next account must not inherit the last one

Nextcloud’s own approval runs in NAS Drive’s embedded window, in a non-persistent store that carries no account session in and leaves none behind. Adding a second user reaches a real login form, not a “grant access” page already signed in as somebody else.

  • Gateway cookies may carry across; account cookies never do
  • Your ordinary Safari or Chrome session is never read, cleared or involved
  • Each account ends with its own device credential, revocable on its own
  • A still-valid gateway session can renew silently without a second sign-in

Four layers, four separate answers

Each layer is discovered, authenticated, stored and expired on its own. Nothing borrows another layer’s result, which is why NAS Drive can tell you which thing lapsed.

LayerWhat sits thereWhat NAS Drive holdsStatus
Layer 0Network prerequisite — VPN, private DNS, WARP, Tailscale, your LANNothing stored. Reachability is measured, never assumedDetected
Layer 1Edge gateway — Cloudflare Access, reverse proxy, authenticated proxyA session cookie, won in your real browser, renewable silentlyAdapter shipped
Layer 2Enterprise identity — OIDC discovery, OAuth 2.0 with PKCE, mutual TLSAn authorization code, exchanged — never a passwordStandards shipped
Layer 3Nextcloud — Login Flow v2, run in the isolated windowA device credential in the Keychain, revocable on its ownShipped
Layer 4Storage and permissions — shares, groups, external storage, NAS availabilityYour server's. NAS Drive holds no authority here at allServer's own

When something lapses, it says which one

The failure mode that loses people’s files is a client that reacts to an authentication problem as though it were a storage problem. These are the four cases and what happens in each.

What happenedWhat NAS Drive doesYour files
Gateway session expiredSays so by name — “Cloudflare Access has expired. Your Nextcloud device credential remains valid.” One button re-authenticates in your browser.Local copies open normally. Remote changes pause and resume.
Device credential revokedReported as its own separate condition, not folded into the gateway notice. You revoked it on the server, so it says that.Nothing local is deleted. Sign in again to resume.
VPN or LAN goneTreated as a route problem. If a second route to the same account is proven, it switches; otherwise it waits.Pinned and downloaded files stay available offline.
Login page instead of filesClassified as an authentication failure, judged against what the item was supposed to be — so a genuine .html file still downloads as a file.Never mistaken for an empty folder. No deletion propagates.

What it speaks, and what it will not pretend to

Solid chips are in the product today. Outlined ones are specified and wait for a reproducible integration test before they are ever advertised as supported.

  • OAuth 2.0 + PKCE
  • OpenID Connect discovery
  • HTTP Basic and Digest
  • Proxy authentication
  • Mutual TLS
  • Private CA trust stores
  • Cloudflare Access
  • Generic OIDC gateway
  • Nextcloud Login Flow v2
  • Entra
  • Okta
  • Keycloak
  • Authelia
  • Pomerium
  • oauth2-proxy
  • Auth0
  • Google IAP
Three steps, once

Connect it, then forget it's there.

After the first sign-in, NAS Drive has no interface you need to visit. The Finder window is the product.

  • 1

    Sign in the way your server expects NAS Drive detects what sits in front of Nextcloud and authenticates each layer separately — the gateway in a browser window, Nextcloud with its own device credential.
  • 2

    Your account appears under Locations One account, one Finder location, whichever address reaches it. A local LAN address and a remote hostname are two routes to the same drive, never two drives.
  • 3

    Open, edit, save, drag, delete Every macOS app writes to it through the normal Open and Save panels. Quick Look, drag and drop, and Spotlight behave the way they do anywhere else on the Mac.
In Finder

A right-click that does the Nextcloud things.

Sharing, links and version history belong to the file on your server. Keeping and releasing local bytes belongs to this Mac. NAS Drive keeps those two ideas apart — no remote action ever appears or disappears because a local copy arrived.

Menu entryWhat it doesActs on
Share…Creates a share through your server's own sharing rules.Server
Manage Access…Lists existing shares, changeable and revocable in place.Server
Copy LinkA working public link on the clipboard, one click.Server
View OnlineOpens the file in Nextcloud in your browser.Server
Version HistoryThe versions your server already keeps.Server
Always Keep on This DeviceA pin that outranks every automatic cleanup path.This Mac
Free Up SpaceReleases local bytes. The server copy is untouched — no delete is reachable from here.This Mac

States you can read

macOS vocabulary, not a private one. Every file in the drive is in exactly one of these, and the word for it is the word Finder already uses.

  • Cloud only
  • Downloading
  • Downloaded
  • Always keep downloaded
  • Uploading
  • Waiting for network
  • Waiting for authentication
  • Conflict
  • Server or storage error
  • A menu-bar controller, not a second file browser Status, current transfers, pause and resume, connection health, diagnostics, disconnect. It deliberately does not mirror your folder tree.
  • Pause that means pause Closing the window keeps syncing. Quit stops every network operation, extension included. Local files stay readable; held writes settle when you come back.
What it refuses to do

A sync client's real job is not losing your files.

Each of these is a rule in the product, closed by a live test before it was allowed to count.

  • NEVER

    Treat a missing NAS mount as a mass deletion.
  • NEVER

    Let a partial or interrupted listing become an authoritative empty folder.
  • NEVER

    Read a gateway login page as a file. HTML where WebDAV was due is an authentication failure.
  • NEVER

    Delete local content because a session expired. Expiry pauses remote work and nothing else.
  • NEVER

    Materialise a file known to be non-empty as zero bytes — guarded on the whole-file and range-read paths alike.
  • NEVER

    Silently overwrite a divergent file. Both copies are kept, under a name you can find.
  • NEVER

    Report a stored credential as a working one. Every status line names a fact and where it came from.
The division of ownership

Everything that matters stays on your server.

NAS Drive is a client. It adds no backend, no relay and no account of its own. If you uninstall it tomorrow, your Nextcloud is exactly as it was.

Privacy, stated plainly

No file-content telemetry. No filenames in analytics. No credential or token logging. Diagnostic bundles redact hosts, identities and paths, and you choose when one is collected.

Stays on your Nextcloud

  • Users, groups and permissions
  • Shares and public links
  • File versions and trash
  • Quotas and external storage
  • Access and audit logs
  • Every byte of file content

Held on this Mac

  • One device credential in the Keychain, revocable from the server on its own
  • A metadata journal paths, sizes, ETags, transfer state — references, never secret values
  • The files you opened or pinned and no others
Roadmap

What's being built, said honestly.

The product only advertises what has been measured. These are in the tree and not finished — listed so you can judge the direction, not so you can plan around them.

  • P2A

    Local Folder & Drive Sync pick folders or whole volumes, map each to a NAS destination
    In progress
  • P2B

    Direct TrueNAS / NAS provider manual enrollment, no Nextcloud in the middle
    Planned
  • P2C

    Local discovery and Mac peer mode device-to-device sync on your own network
    Planned
  • R2

    Android app and system file picker DocumentsProvider, so any app can open and save
    Planned
  • R3·R4

    iOS with Apple Files, Windows in File Explorer after macOS and Android pass their release gates
    Planned
  • NEARBY

    Device-to-device sharing over LAN and Bluetooth peer identity, pairing and transport broker crates exist in the Rust core
    Planned
Requirements

What you need to run it.

A Nextcloud you already run

On a NAS, a home server, a VPS or a hosted instance. Generic WebDAV servers connect too, with a reduced set of features — sharing and version history come from Nextcloud.

A Mac

NAS Drive installs as a Finder File Provider extension. macOS requires a containing application to host it; that app stays out of your Dock after setup.

HTTPS, or a private network

HTTPS is recommended everywhere. Plain HTTP to a LAN Nextcloud is allowed only per route, only on a private or tunnelled network, and is refused outright on a public one.

Questions

Before you ask.

No. There is no NAS Drive server, no relay and no account. Content moves between your Mac and your Nextcloud, and nowhere else. What stays locally is what you opened or pinned.

Files list as placeholders and download when you open them. Free Up Space releases local bytes and leaves the server copy alone. Always Keep on This Device is the opposite promise, and it outranks every automatic cleanup path.

That case is the reason the product exists. The gateway is authenticated in a browser window and its session is tracked separately from your Nextcloud credential, so when one expires the other keeps working and the notice tells you which is which.

Pinned and previously downloaded files open normally. Changes queue and settle when the connection returns. An outage never triggers deletion, on either side.

No. Finder is the interface. What’s installed alongside it is a menu-bar status item and a settings window — neither of which shows you a second copy of your folder tree.

Generic WebDAV works today. A direct NAS provider that skips Nextcloud entirely is on the roadmap and is not built yet.

Your NAS. Your Nextcloud. Your Finder.

NAS Drive is in owner-gated testing while its release gates close. Ask to be told when a signed build is available.