deeplo

deeplo

A small, self-hosted, agentless deployment tool for Docker Compose projects.

deeplo deploys Docker Compose projects to remote hosts over SSH. It is intentionally small: no dashboard, no database, no agents on target hosts.

Start Here

Quickstart

Zero to a running daemon in one page

Configuration

YAML config: hosts, repos, projects, watch paths

Bootstrap config

All DEEPLO_* runtime env vars

CLI reference

deeplo commands and expected output

Install path

  1. Install the deeplo binary on your host.
  2. Create /etc/deeplo/config.yml — describes your hosts, repos, and projects.
  3. Create /etc/deeplo/deeplo.env — runtime settings (data dir, SSH key, etc.).
  4. Run deeplo daemon as a systemd service.
  5. Use deeplo health, deeplo status, deeplo runs to observe the install.

Docker Compose deployment is also supported — see Run with Docker.

What It Does

  • Detects new commits by webhook, poll, or both
  • Selects affected projects using repo/branch matching and watch_paths
  • Extracts compose and env files from the exact commit
  • Uploads and runs the project over SSH with docker compose
  • Records deployment history in local JSON state files

Documentation

Guides

Install, configure, operate, troubleshoot

Reference

Config schema, CLI commands, state files

Internals

Deployment model, architecture, development

Guides

Task-oriented guides for installing, configuring, and operating deeplo.