Documentation
Self-hosted deploy, observability, and developer tools — one binary each, free, MIT or AGPL. Pick a section below or jump into the quick start.
Getting started
What Teploy is, how the ecosystem fits together, and your first deploy.
- Introduction — Learn what Teploy is and how the ecosystem fits together.
- Quick Start — Deploy your first app in under 5 minutes with the teploy CLI.
- Core Concepts — Understand the key concepts behind Teploy — state files, zero-downtime deploys, accessories, and how the tools fit together.
Deploying
Static sites, containers, databases, GitHub integration.
- Deploy from GitHub — Set up webhook-triggered auto-deploys with the teploy CLI.
- Docker Deploys — Deploy Docker containers with the teploy CLI.
- Deploy from Forgejo — Connect Forgejo to Teploy with one-command webhook auto-deploy or a test-gated Forgejo Actions workflow.
- Databases — Deploy and manage databases as CLI accessories alongside your apps.
- Static Sites — Deploy static sites with the teploy CLI — native rsync hosting or Docker + Caddy.
Observe
Self-hosted analytics, APM, error tracking, logs and session replay.
- Observe — Self-hosted analytics, APM, error tracking and session replay in one binary.
- Install Observe — Install Observe with Homebrew, Docker or from source, and upgrade safely.
- Observe quick start — From a fresh install to a query-visible first event.
- Observe SDKs — Tracker scripts, browser and server SDKs, and migrating from Sentry or PostHog.
- Configure Observe — The environment variables that matter, separating ingest from the dashboard, and OIDC SSO.
Ship
The self-hosted coding agent: issues in, verified pull requests out.
- Ship — A self-hosted coding agent — issues in, verified pull requests out.
- Ship quick start — Run your first task, live or durable, and answer approvals from the terminal.
- Ship harnesses — The native loop, Claude Code and OpenCode as harnesses, and how they are baked into sandbox images.
- Self-host Ship — Install on a clean VM, join a second box, wire webhooks, and let runs publish preview deploys.
Domains
Custom domains, automatic SSL via Let's Encrypt, Cloudflare setup.
- Custom Domains — Point your own domain at a teploy app.
- Cloudflare Setup — Optional CDN and security in front of a teploy-deployed app.
- SSL Certificates — Automatic SSL via Caddy for every public domain.
Servers
Provisioning, configuration, and operating your fleet.
- Provisioning Servers — Turn a fresh VPS into a teploy-ready deploy target.
- Managing Servers — Monitor and manage your servers from the CLI.
- Scaling — Scale your infrastructure horizontally and vertically.
Reference
CLI commands, configuration files, and API specifications.
- CLI Reference — Complete reference for all teploy CLI commands.
- teploy.yml Reference — Full field reference for teploy.yml — the canonical schema for every app config.
- Secrets — Encrypted secrets from the local age store to OpenBao — dynamic credentials, HA, and audit streaming.
- Environment Variables — Configure environment variables for your apps.
- Recommended Services — Complementary services that work great with Teploy.
- Roadmap — Current product status and upcoming features for Teploy.