Docker Setup

Run the Crow gateway in Docker for self-hosted deployments.

Prerequisites

• Docker and Docker Compose installed
• A Turso database (or use local SQLite)

Cloud Profile

Exposes the gateway on port 3001:

docker compose --profile cloud up --build

Set environment variables in a .env file or pass them directly:

TURSO_DATABASE_URL=libsql://your-db.turso.io
TURSO_AUTH_TOKEN=your-token

Local Profile

Runs the gateway with a Cloudflare Tunnel for remote access:

docker compose --profile local up --build

This creates a public URL via Cloudflare that you can use to connect from mobile/web AI clients.

Environment Variables

The gateway reads all integration API keys from environment variables. See the Integrations page for the full list.

Security note: If you're exposing the gateway to the internet, always use a reverse proxy (nginx, Caddy, or Cloudflare Tunnel) with HTTPS. Never expose port 3001 directly to the public internet without TLS encryption. The --no-auth flag should never be used in internet-facing deployments.

Health Check

Verify the gateway is running:

curl http://localhost:3001/health

Visit http://localhost:3001/setup to see integration status and endpoint URLs.