😎Based

Self-Hosting

Run Based on your own infrastructure with your own storage.

S3-Compatible Storage

Based works with any S3-compatible storage provider. We recommend:

  • Storj — Decentralized, S3-compatible, great pricing. Our default for production.
  • AWS S3 — The original. Works out of the box.
  • MinIO — Self-hosted S3. Run alongside Based.
  • Cloudflare R2 — Zero egress fees.

Environment Variables

# S3 Storage
S3_ENDPOINT=https://gateway.storjshare.io
S3_ACCESS_KEY=your-access-key
S3_SECRET_KEY=your-secret-key
S3_BUCKET=your-bucket-name
S3_REGION=us-east-1

# Auth (Privy)
NEXT_PUBLIC_PRIVY_APP_ID=your-privy-app-id
PRIVY_APP_SECRET=your-privy-secret

# Collaboration (optional)
HOCUSPOCUS_URL=wss://your-hocuspocus-server.com

Deploy

Based is a standard Next.js app. Deploy anywhere that runs Node.js:

  • Vercel (zero-config)
  • Railway / Render / Fly.io
  • Docker (Dockerfile included)
  • Any VPS with Node.js 20+

Data Ownership

Because your data is just JSON files in a bucket you control, you can:

  • Query entities directly with any S3 client or CLI
  • Back up your entire workspace by copying the bucket
  • Migrate between storage providers by syncing buckets
  • Audit every change through the immutable oplog
  • Restore deleted data from the trash within the retention window