Skip to Content
DocsCloud OSOrbit Drive

Orbit Drive

Orbit Drive is your self-hosted file vault, sitting alongside Orbit Docs / Sheets / Slides / Notes in the Workspace family. Files live on your server, deduplicate automatically, version themselves on every change, and mount in Finder / Files Windows / GNOME Files via WebDAV — no install required.

It’s our answer to Google Drive and Nextcloud. Available on every plan; sharing limits scale with your tier.

What you get

  • Two-pane web UI — folder tree on the left, file list + preview on the right. Drag-drop upload, multi-select, breadcrumbs, keyboard nav.
  • Native sync via WebDAV — mount your Drive as a network drive in any modern OS. No client install. Authenticate with a per-app password you mint in Settings.
  • Content-addressable storage — under the hood, Drive stores objects keyed by SHA-256. Uploading the same bytes twice is free; identical files take one slot in storage.
  • Version history — every change snapshots the previous content. Retention scales with your plan: 24 hours on Community, 90 days on Pro, 180 days on Business, 365 days on Enterprise.
  • 30-day trash — soft-delete keeps a copy for 30 days before permanent removal. Restore with one click; empty trash to free space immediately.
  • Share links — token-protected public URLs. Read-only or read-write, optional expiry / password / download cap. Free tier: 3 active shares; Pro+ unlimited.

Mounting Drive in Finder / Explorer

  1. Open Settings → WebDAV access.

  2. Click New WebDAV password, give it a label like “Mac Finder”, click Create.

  3. The password is shown once — copy it now.

  4. Mount:

    • macOS Finder → ⌘K → enter https://<your-quazzar-host>/dav/drive → connect with your Quazzar username + the WebDAV password.
    • Windows Explorer → “Map network drive” → use the same URL → tick “Connect using different credentials”.
    • GNOME Files → Other Locations → enter davs://<your-quazzar-host>/dav/drive.
    • rclone → rclone config → webdav → URL https://<your-quazzar-host>/dav/drive, vendor other, username + password.

  5. Drag-drop files; they sync in real time. Reads stream directly from the underlying object store via short-lived presigned URLs, so transfers don’t hop through the OS process.

Storage limits

Drive uses the embedded MinIO instance that already powers Object Storage on your node. Storage capacity is whatever you’ve allocated to MinIO under Server Mode → Object Storage → Pools. There’s no per-user quota in the MVP — that arrives in a later release alongside billing tiers.

Sharing

To share a file or folder:

  1. Right-click the row in the file list (or select it and click Share in the bulk-action toolbar).
  2. Pick Read-only or Read-write. Read-write lets the recipient upload into the shared folder.
  3. (Optional) Set an expiry, a password, or a download cap.
  4. Click Create share — the URL is now live. Copy and send it.

To revoke a share, go to Settings → Drive shares → revoke.

🔒 Pro+ unlocks unlimited active shares (Community is capped at 3).

API

Every Drive operation is also a REST endpoint, so you can script anything:

  • GET /api/drive/tree?folder_id=… — list a folder’s children.
  • POST /api/drive/upload — multipart upload (small files).
  • POST /api/drive/upload/init + chunk + finish — chunked upload (large files).
  • GET /api/drive/raw/{node_id} — 302 redirect to a presigned download URL.
  • POST /api/drive/nodes/{id}/share — create a share link.

See the API reference for full endpoint shapes.

What’s not yet there

  • Real thumbnailing — preview currently redirects to raw; browsers do the rendering. Real thumbnail generation (libvips) is a follow-up.
  • Office-doc preview — DOCX/XLSX/PPTX viewers come with the Forms / Mail roadmap.
  • Mobile sync — pairs nicely with the upcoming Quazzar mobile app (see Mobile Pairing).
  • Cluster-wide replication — single-node only in MVP; multi-node Drive arrives with the Networking phase.
Orbit NotesOrbit Mail