Complete Guide to EPD (Easy Project Deployer)

epd is a zero-downtime deployment tool designed to deploy any application to one server or a fleet of servers over standard SSH. It combines zero-downtime blue/green deployments, automatic Let's Encrypt SSL, a shared reverse proxy (Traefik), and multi-host load balancing without requiring Kubernetes or complex container orchestration.

---

Documentation Hub

Explore the topics below for in-depth documentation and examples:

🚀

Getting Started (5 Min)

Step-by-step tutorial: initialize, configure, setup, and deploy your first application.

📦

Prerequisites & Installation

Zero-dependency installer, package manager commands, and automated SSH onboarding.

🏗️

Architecture & Request Flow

How Traefik routes incoming traffic, filesystem layouts, and zero-daemon design.

🔄

Zero-Downtime Blue/Green

The deployment lifecycle: idle slot booting, health checks, atomic route switching, and draining.

🐳

Docker vs. Process Mode

Run containerized apps with Docker, or deploy plain Bun/Node/Python code via PM2.

🌐

Multi-Site on Single VPS

Host dozens of independent domains on a single host without port collisions.

⚡

High Availability & Clusters

Cross-host load balancing, private VPC network routing, and rolling rollouts.

🔀

Advanced Routing & Traefik

Path stripping, subdomains, basic auth, redirects, sticky sessions, and wildcard SSL.

🔒

Secrets & Environments

Safe secret resolution, destination overlays (staging vs production), and chmod 0600 storage.

🗄️

Accessories (Databases & Caches)

Persistent Postgres, Redis, and MinIO containers with volume management and web UIs.

🤖

GitHub Actions CI/CD

Automated continuous deployment on every git push with a 20-line workflow file.

☁️

Hetzner Cloud & DNS

Dynamic server targets, CLI provisioning, and Cloudflare/Hetzner DNS auto-sync.

💻

CLI Commands Reference

Full documentation of all 28 commands, options, and flags from epd doctor to epd top.

⚙️

Configuration Reference (epd.yml)

Complete annotated YAML schema specification with every possible configuration key.

🛠️

Troubleshooting & Operations

Resolving deployment locks, diagnosing probe timeouts, and disaster recovery.