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.
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.