# Watasu documentation

> Build, deploy, and operate apps, managed services, and agent sandboxes on Watasu.

Every documentation page has a Markdown counterpart: `/apps/deploy/` becomes `/apps/deploy.md`, and the home page is `/index.md`. These files are generated from the same content as the website.

## Documentation

- [ClickHouse](https://docs.watasu.io/addons/clickhouse.md): Managed ClickHouse for analytics, event data, and large append-heavy datasets.
- [Object Storage](https://docs.watasu.io/addons/object-storage.md): S3-compatible object storage for uploads, assets, exports, and archives.
- [Add-ons Overview](https://docs.watasu.io/addons/overview.md): Managed services you attach to apps — what they are, how to pick, and how attachment works.
- [PostgreSQL](https://docs.watasu.io/addons/postgresql.md): Managed PostgreSQL on Watasu — creation, plans, followers, backups, and the restore workflow.
- [Qdrant](https://docs.watasu.io/addons/qdrant.md): Native vector and hybrid search with Qdrant REST and gRPC clients.
- [Redpanda](https://docs.watasu.io/addons/redpanda.md): Managed Kafka-compatible streaming for durable event pipelines.
- [Valkey](https://docs.watasu.io/addons/valkey.md): Managed Valkey for caching, sessions, rate limiting, and ephemeral state. Speaks the Redis protocol.
- [Billing and Limits](https://docs.watasu.io/admin/billing-and-limits.md): Prepaid balance billing, what you pay for, and the limits that shape app and add-on usage.
- [Teams and Access](https://docs.watasu.io/admin/teams-and-access.md): Organize apps by team, grant per-app and per-pipeline roles, and keep build-failure noise off the people who don't need it.
- [Configuration](https://docs.watasu.io/apps/configuration.md): Manage runtime configuration with config vars, plus app.json for repeatable bootstraps.
- [Custom Domains](https://docs.watasu.io/apps/custom-domains.md): Attach your own domains to public web processes with managed TLS.
- [Deploy an App](https://docs.watasu.io/apps/deploy.md): Create an app, push code, and ship a release with Git, Dockerfile, or buildpacks.
- [Logs and Releases](https://docs.watasu.io/apps/logs-and-releases.md): Use logs and the release timeline to debug deploys and runtime behavior.
- [Private Networking](https://docs.watasu.io/apps/private-networking.md): Run private internal services with *-tcp processes and let trusted apps reach them — no DNS, no certificates, no VPC plumbing.
- [Processes and Scaling](https://docs.watasu.io/apps/processes-and-scaling.md): Run multiple process types, scale replicas, and choose pod sizes. Covers web, workers, multiple public web entrypoints, private TCP services, RTC processes, and release processes.
- [Real-Time and WebRTC](https://docs.watasu.io/apps/realtime.md): Run SFUs, voice agents, and real-time apps with *-rtc processes. Each gets a dedicated TURN gateway, a public UDP port, and stable per-replica hostnames.
- [Authentication](https://docs.watasu.io/cli/authentication.md): Log in with browser auth or an API key, and understand how the CLI picks an app.
- [Install the CLI](https://docs.watasu.io/cli/install.md): Install the watasu CLI on macOS, Linux, WSL, or Windows.
- [CLI Command Reference](https://docs.watasu.io/cli/reference.md): Every watasu CLI command, in one searchable page.
- [Core Concepts](https://docs.watasu.io/getting-started/concepts.md): The words that explain how Watasu works — app, build, release, process, formation, add-on, sandbox, team.
- [Introduction](https://docs.watasu.io/getting-started/introduction.md): What Watasu is, who it's for, and what it removes from your plate.
- [Quickstart](https://docs.watasu.io/getting-started/quickstart.md): Deploy your first app to Watasu in five minutes.
- [Watasu Docs](https://docs.watasu.io/index.md): Ship apps without operating servers, clusters, ingress, or databases.
- [Logs](https://docs.watasu.io/observability/logs.md): Centralized application logs, searchable in Grafana.
- [Metrics](https://docs.watasu.io/observability/metrics.md): Prometheus-style metrics scrape, queries, and alerts in Grafana.
- [Observability Overview](https://docs.watasu.io/observability/overview.md): How logs, metrics, traces, and Grafana fit together on Watasu.
- [Traces](https://docs.watasu.io/observability/traces.md): Distributed tracing for understanding where requests spend their time.
- [Add-on Environment Variables](https://docs.watasu.io/reference/addon-env-vars.md): Exact env vars exported by each add-on, and how aliases prefix them.
- [Add-on Plans](https://docs.watasu.io/reference/addon-plans.md): Plan slugs and what each tier includes for each managed service.
- [app.json Schema](https://docs.watasu.io/reference/app-json.md): Full reference for app.json — fields, types, examples, and what each one does.
- [Glossary](https://docs.watasu.io/reference/glossary.md): Watasu vocabulary in plain language.
- [Pod Sizes](https://docs.watasu.io/reference/pod-sizes.md): Available pod sizes and how to think about scaling up vs. scaling out.
- [Regions](https://docs.watasu.io/reference/regions.md): Where apps and add-ons run.
- [Sandbox Billing](https://docs.watasu.io/sandboxes/billing.md): How sandbox runtime, retained disks, checkpoints, and templates are billed.
- [Checkpoints](https://docs.watasu.io/sandboxes/checkpoints.md): Capture sandbox disk state and restore it into a new sandbox.
- [Files and Processes](https://docs.watasu.io/sandboxes/files-and-commands.md): Read and write sandbox files, list directories, and stream process output.
- [Networking and Ports](https://docs.watasu.io/sandboxes/networking.md): Configure sandbox egress and expose explicit public HTTP preview ports.
- [Sandboxes Overview](https://docs.watasu.io/sandboxes/overview.md): Create isolated Linux sandboxes for agent work, code execution, file operations, and short-lived services.
- [SSH](https://docs.watasu.io/sandboxes/ssh.md): Open a shell in a fresh sandbox with a single ssh command — no SDK, no client install.
- [Sandbox Templates](https://docs.watasu.io/sandboxes/templates.md): Build reusable sandbox environments with packages, setup commands, runtime baselines, and build logs.
- [Common Issues](https://docs.watasu.io/troubleshooting/common-issues.md): Diagnose deploy failures, missing logs, pending domains, and add-on connection errors.
- [Backups and Restores](https://docs.watasu.io/workflows/backups-and-restores.md): Capture, list, restore, and promote backups for PostgreSQL, Valkey, and ClickHouse.
- [Connect GitHub](https://docs.watasu.io/workflows/connect-github.md): Auto-deploy from a branch and let GitHub checks gate your releases.
- [Connect AI Assistants (MCP)](https://docs.watasu.io/workflows/mcp.md): Give Claude and other MCP clients read-only visibility into your apps, builds, and add-ons.
- [Pipelines and Promotions](https://docs.watasu.io/workflows/pipelines.md): Stage delivery with multi-app pipelines and promote built artifacts between environments.
- [Review Apps](https://docs.watasu.io/workflows/review-apps.md): Spin up a real environment for every pull request, automatically.