# 2server documentation

> Deploy and operate apps on infrastructure you own. Start with one prompt for your coding agent.

## Start here
- [Quick start (English)](https://2found.dev/docs/2server/index.md): Start with one agent prompt, choose an existing VM or provision on GCP/AWS, create a Cloudflare token and deploy your first app.
- [Bắt đầu nhanh (Tiếng Việt)](https://2found.dev/vi/docs/2server/index.md): Start with one agent prompt, choose an existing VM or provision on GCP/AWS, create a Cloudflare token and deploy your first app.

## Reference
- [Documentation index](https://2found.dev/docs/2server/reference/index.md): Find the 2server reference for deployment, source configuration, VM recovery, service templates, extension development and releases.
- [Claude & Codex plugins](https://2found.dev/docs/2server/agent-plugins/index.md): Install the 2server skill from the repository marketplace in Claude Code or Codex, configure the CLI and keep the plugin up to date.
- [Source configuration](https://2found.dev/docs/2server/source-config/index.md): Reference for 2server App, Domain and Zone files: images, resources, health checks, secret references, bindings, migrations and Cloudflare policy.
- [Operator guide](https://2found.dev/docs/2server/operator-guide/index.md): Provision and connect VMs, configure Cloudflare credentials, adopt existing Compose apps and operate workloads with the 2server CLI.
- [Cloudflare tokens](https://2found.dev/docs/2server/cloudflare-tokens/index.md): Create a Cloudflare token with the required Account and Zone permissions and resource scope for domains, WAF, email, Workers and D1.
- [Control state & recovery](https://2found.dev/docs/2server/control-state/index.md): Manage VM-owned configuration and secrets, portable connections, encrypted control backups, recovery and interrupted 2server operations.
- [Locks & concurrency](https://2found.dev/docs/2server/locking/index.md): Understand 2server resource locks, concurrent app releases, snapshot conflicts, interrupted operations and deliberate lock recovery.
- [Reliability](https://2found.dev/docs/2server/reliability/index.md): Plan app readiness, blue/green capacity, monitoring, single-VM availability and durable Redis and NATS services on your infrastructure.
- [PostgreSQL](https://2found.dev/docs/2server/postgres/index.md): Configure named PostgreSQL instances, credentials, roles, pgBackRest backups and isolated restore verification with 2server.
- [Email routing](https://2found.dev/docs/2server/email-routing/index.md): Configure Cloudflare inbound email forwarding with named 2server apps, verified destinations, scoped permissions and ownership checks.
- [CLI architecture](https://2found.dev/docs/2server/architect-cli/index.md): Understand 2server command routing, module ownership, domain and infrastructure layers, credentials, lifecycle and extension contracts.
- [Extension authoring](https://2found.dev/docs/2server/extensions/index.md): Build 2server service recipes, native hooks, external runtimes and template commands while preserving named-instance isolation and lifecycle contracts.
- [Extension boundaries](https://2found.dev/docs/2server/extension-boundaries/index.md): Reference for 2server extension ownership, instance binding, shared capabilities, explicit registration and retained compatibility boundaries.
- [Development](https://2found.dev/docs/2server/development/index.md): Set up the 2server source checkout and run local tests, type checks, isolated Docker checks and Terraform verification before release.
- [Release runbook](https://2found.dev/docs/2server/release/index.md): Verify the packed and installed 2server CLI, publish releases and perform staging acceptance checks without confusing mocks with live evidence.
- [Roadmap](https://2found.dev/docs/2server/roadmap/index.md): Explore design directions for 2server, including object storage, edge lifecycle and optional Soot operations; proposals are not shipped capabilities.
- [Source architecture (legacy link)](https://2found.dev/docs/2server/architecture/index.md): The retained 2server source architecture reference links to the canonical CLI architecture guide for current module and lifecycle rules.

## Optional
- [Product source](https://github.com/2found/2server/tree/d4f8355f4773c3982abe051629246c81380c4781): Pinned source and runtime contracts.