# Duploy

> Hosted PaaS driven by one duploy.toml file in your repository.

One duploy.toml in your repository describes every service, worker, cron job and database. Push, and Duploy builds and rolls it out.

## Table of Contents

### Start

- [Getting started](/guide/getting-started.md): Install the duploy CLI, sign in, describe your app in duploy.toml and ship the first deploy.
- [How Duploy works](/guide/how-it-works.md): The duploy.toml config model, staged edits, builds, rolling deploys and internal networking.

### Configure

- [Services](/guide/services.md): Web services, workers and cron jobs; build sources, image sources, health checks, replicas, resources and egress rules.
- [Environment and secrets](/guide/environment.md): Environment variables, secrets, database and service references, inherit_env, platform variables and config files.
- [Domains and TLS](/guide/domains.md): Route hosts and paths to services, automatic Let's Encrypt certificates, domain ownership and gRPC.
- [Volumes](/guide/volumes.md): Persistent volumes for services, their size, scheduled snapshots and restore.
- [Cron jobs](/guide/cron.md): Scheduled one-shot jobs with timeouts, overlap handling and manual runs.
- [Managed databases](/guide/databases.md): Managed Postgres, MySQL and Redis; extensions, backups, point-in-time restore, dump import, roles and row-level security.

### Operate

- [CI and automation](/guide/ci.md): Deploy from CI with a personal access token, wait for events with duploy until, and script with JSON output.
- [Statuses](/guide/statuses.md): The status vocabulary shared by the panel and the CLI; every state is a glyph plus a colour.

### Reference

- [duploy.toml](/reference/duploy-toml.md): Every key of duploy.toml with its type, default and rules.
- [CLI](/reference/cli.md): Every duploy CLI command, grouped by area, with global flags and context resolution.