Native install

Install

curl -fsSL https://deeplo.xyz/install.sh | sh

The script installs the binary, creates a service user and deploy key, and installs the systemd unit.

Edit the config

Open the config with deeplo config edit and replace the example values with your own:

hosts:
  - name: web-1
    address: 10.0.0.10 # your host IP or hostname
    deploy_dir: /srv/apps

repos:
  - name: myapp
    url: git@github.com:yourorg/myapp.git
    branch: main

projects:
  - name: myapp
    repo: myapp
    repo_subdir: deploy # directory in repo containing compose.yml
    persist_files:
      - .env
    targets:
      - web-1

Then validate it:

deeplo config check

See Config file for the full schema.

Authorize the deploy key

Open the env file with deeplo env edit and confirm DEEPLO_SSH_USER matches your deploy user. If you need to create one, see the deploy user. Then install the deploy key on each target:

deeplo authorize          # all configured hosts, prompts for each host's password

This authorizes the daemon to SSH into each configured host with its configured user and port.

To do it manually, append the contents of /etc/deeplo/keys/deploy_key.pub to ~/.ssh/authorized_keys for the deploy user on each target.

The daemon uses the same key to fetch your repos over SSH. For private repos, grant that key read access. On GitHub, for example, you can add deploy_key.pub as a read-only deploy key.

Start the daemon

deeplo service enable --now   # start now, and on every boot
deeplo health                 # confirm it's running and reachable

On start, the daemon reconciles your config and deploys every configured project at its current commit, so your first deploy begins right away.

Watch the first deploy

Follow it in the logs:

deeplo service logs -f

Then check the result:

deeplo deploys state          # latest state per project-host
deeplo deploys history        # recent runs
deeplo deploys logs <run-id>  # log for a run (id from history)

To see all available commands, use deeplo --help or browse the CLI reference.