deeplo
Guides

Guides

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

Quickstart

Zero to a running daemon in one page

Install on Linux

Binaries, paths, systemd service, and upgrade steps

Run with Docker

Run deeplo as a Docker Compose service

Bootstrap config

All DEEPLO_* runtime env vars

Triggers

Webhook, poll, and hybrid — how deploys fire

GitHub reporting

Deployment statuses, commit statuses, and run logs

Security

SSH trust model, deploy key setup, secrets

Troubleshooting

Common failures and what to check first

The standard deeplo setup:

  1. Install the deeplo binary
  2. Create a deeplo service user and standard directories
  3. Write /etc/deeplo/config.yml — hosts, repos, projects
  4. Write /etc/deeplo/deeplo.env — runtime settings
  5. Install the deeplo.service systemd unit
  6. Start with systemctl enable --now deeplo
  7. Verify with deeplo health and deeplo status

Start with the Quickstart if you're setting up for the first time. If you prefer containers, see Run with Docker.

Advanced topics

DEEPLO_CONFIG_WATCH and git-managed config are described in Bootstrap config. They're useful for specific workflows but not required for the default setup.

deeplo

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

Quickstart

Install deeplo and run your first deploy in minutes.