# Coop Docs

> Official setup, self-hosting, configuration, and operations documentation for Coop.

Start with the guided setup. Prefer the Markdown links below when helping a person install Coop. Ask the person before creating provider resources, changing DNS, or entering secrets. Never ask them to paste database passwords, API secrets, encryption keys, or private message data into chat.

## Start here

- [Self-host Coop](/self-host/index.md): Architecture, boundaries, and complete setup order.
- [Set up Coop with an AI agent](/self-host/agent-setup/index.md): A complete interview, planning, execution, safety, and verification prompt for an installation assistant.
- [Prepare accounts and ownership](/self-host/prepare/index.md): Required accounts, public URLs, release archive, and recovery ownership.
- [Full documentation](/llms-full.txt): All setup and reference pages in one Markdown document.

## Setup

- [Set up Coop with an AI agent](/self-host/agent-setup/index.md): Give an AI assistant the complete Coop documentation, then let it build and guide only the setup path your company needs.
- [Prepare accounts and ownership](/self-host/prepare/index.md): Decide who owns the installation, collect the required accounts, and choose stable public URLs.
- [Set up Supabase](/self-host/supabase/index.md): Create PostgreSQL and private S3-compatible attachment storage without exposing Supabase keys to the browser.
- [Set up Clerk](/self-host/clerk/index.md): Create the production sign-in application and add the verified email claims that Coop invitations require.
- [Deploy the API on Railway](/self-host/backend-railway/index.md): Deploy the Coop API with a managed Redis service, safe migrations, and health checks.
- [Deploy the API on Fly.io](/self-host/backend-fly/index.md): Launch the API from its checked-in Fly configuration and attach managed data services.
- [Deploy the dashboard on Vercel](/self-host/frontend-vercel/index.md): Deploy the dashboard from the Coop release with its Clerk and API values.
- [Deploy the dashboard on Cloudflare Pages](/self-host/frontend-cloudflare/index.md): Build the dashboard from the Coop release and upload it directly to Cloudflare Pages.
- [Install and pair Coop Relay](/self-host/relay/index.md): Prepare the Mac, build Relay for the self-hosted API, grant permissions, and pair it to the organization.
- [Verify, back up, and operate](/self-host/verify-and-operate/index.md): Prove the complete path, document recovery, and give IT a repeatable operating checklist.

## Reference

- [Configuration](/reference/configuration/index.md): Every production setting, where it belongs, and whether users can see it.
- [Troubleshooting](/reference/troubleshooting/index.md): Start from the visible symptom and check the narrowest dependency boundary first.