Docs
Menu

Run it on your infrastructure

Self-host Coop.
Keep your team close.

A practical guide for a company owner, operations lead, or IT team. You will connect the services, deploy the app, pair a Mac, and leave with a tested recovery plan.

Start the guided setup
YOUR COOPReady
⌁
Browser dashboardVercel or Cloudflare
{ }
Coop APIRailway or Fly.io
PostgreSQLRedisS3 storageClerk
●
Mac running Apple MessagesCoop Relay stays online

Recommended path

One setup journey.
Clear choices.

Use the default path if you want the fewest decisions. Each alternative guide says exactly what changes.

  1. 01
    Create the foundation

    Supabase provides PostgreSQL and private S3-compatible storage. Clerk provides sign-in.

  2. 02
    Deploy the API

    Railway is the guided default. Fly.io is the operator-focused alternative.

  3. 03
    Deploy the dashboard

    Use the Vercel button or the Cloudflare button, then connect its public URL to the API.

  4. 04
    Pair your Mac

    Install Relay on an always-on Mac, grant the required permissions, and choose what your team can see.

  5. 05
    Verify and protect

    Test sign-in, direct links, message sync, storage, backups, and encryption-key recovery.

Deployment shortcuts

Start in the right place.

Dashboard guides upload files from the extracted release folder. Backend providers need your database, storage, and Clerk values first.

Vercel

Upload the dashboard from the extracted release folder with two public build values.

Open Vercel guide

Cloudflare Pages

Build locally and upload the static dashboard directly to a Pages project.

Open Pages guide

Before you begin

Self-hosted does not mean one server.

Coop keeps the application under your control, but it still depends on identity, a database, a search cache, object storage, and a Mac. The guided setup makes those boundaries visible so your team knows what to back up and who owns each account.

Review the checklist