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 → Control Center and scroll to 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 stores files in the node’s Garage object store (the S3 Object Storage component), in the quazzar-drive bucket. Capacity is the free space of the disk that holds /var/lib/quazzar/garage/data. 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, open the file’s Share dialog in Drive and revoke the link there. Revoking asks for confirmation.

🔒 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.