# zero

> One-command Docker container deployment for your own Linux server. Automatic HTTPS via Let's Encrypt, zero-downtime atomic swaps, preview environments, webhook auto-deploy, Docker Compose support. Open source, MIT licensed. Single-server scope by design — no Kubernetes, no YAML, no platform fees.

zero is a self-hosted deployment engine that gives you platform DX (Heroku/Vercel-style ergonomics) on hardware you own. You hand it a Docker image — it pulls, starts the container on an ephemeral port, runs a TCP or HTTP health check, and atomically swaps traffic. If the health check fails, the previous version keeps serving. Authentication is SSH — if you can SSH into the server, you can use zero. Config is per working directory (`.zero/config.json`), so you can manage multiple servers from different project dirs.

Scope: one server, any number of apps. Not for multi-node orchestration, team RBAC, or web dashboards.

## Docs

- [Landing page](https://shipzero.sh/): Product overview, features, manifesto, comparison vs PaaS / DIY.
- [Documentation](https://shipzero.sh/docs.html): Full reference — quickstart, deploy, env vars, volumes, registries, Compose, logs & metrics, rollback, domains, previews, webhooks, reverse proxy, TLS, CLI reference, server config, upgrade, uninstall.
- [llms-full.txt](https://shipzero.sh/llms-full.txt): Single plain-text file containing the entire landing page and documentation, formatted for LLM consumption.

## Quickstart

- [Set up the server](https://shipzero.sh/docs.html#server-setup): `curl -fsSL https://shipzero.sh/install.sh | sudo bash`
- [Install the CLI](https://shipzero.sh/docs.html#cli-install): `curl -fsSL https://shipzero.sh/cli/install.sh | bash`
- [Connect via SSH](https://shipzero.sh/docs.html#authentication): `zero login root@example.com`
- [Deploy](https://shipzero.sh/docs.html#deploy): `zero deploy ghcr.io/shipzero/demo:latest`

## Source

- [GitHub repository](https://github.com/shipzero/zero): Source code.
- [MIT License](https://github.com/shipzero/zero/blob/main/LICENSE): License text.

## Optional

- [Built by @rbluethl](https://x.com/rbluethl)
- [codebeam](https://codebeam.com)