deeplo

Configuration model

How the config file and environment variables fit together.

deeplo uses two configuration surfaces:

  • Environment variables configure the daemon process: data directory, SSH key, ports, tokens, logging.
  • The config file describes deployments: hosts, repos, projects, branches, targets, watch paths.

The daemon reads the environment first, then loads the config file from local disk or from git. A valid config can replace the active one while the daemon is running. An invalid reload is rejected and the current config stays active.

Safe to version

The config file can live in source control because it should not contain raw secrets. It can be read from local disk or from a git repo. See Config sources. When useful, YAML values can also reference environment variables with ${VAR} or ${VAR:-default}. See Config file.