> ## Documentation Index
> Fetch the complete documentation index at: https://docs.osschat.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Hosting Overview

> Deployment options and architecture decisions for self-hosting OpenChat.

# Self-Hosting Overview

OpenChat supports two primary deployment patterns:

1. Vercel + Convex Cloud (recommended managed path).
2. Docker-based deployments for containerized environments.

## Choose a Path

| Path                  | Best for                  | Tradeoffs              |
| --------------------- | ------------------------- | ---------------------- |
| Vercel + Convex Cloud | Fast setup, managed infra | Vendor-managed runtime |
| Docker                | Custom infra control      | More ops overhead      |

## Production Requirements

* GitHub OAuth app configured for production callback URL.
* Convex production deployment and keys.
* `OPENROUTER_ENCRYPTION_KEY` configured for provider credentials.
* Optional Upstash services for cache/rate limits/workflow queue.

## Related Guides

<CardGroup cols={3}>
  <Card title="Environment Variables" icon="gear" href="/self-hosting/environment">
    Configure all required deployment secrets and URLs
  </Card>

  <Card title="Docker Deployment" icon="docker" href="/self-hosting/docker">
    Run OpenChat in containers with Compose
  </Card>

  <Card title="Vercel + Convex Cloud" icon="cloud" href="/self-hosting/vercel-convex">
    Ship with managed web and backend infrastructure
  </Card>
</CardGroup>