Platform variables

Every variable Deplo itself reads, to configure the platform.

These configure the platform. For variables your apps read at runtime, see Environment variables.

Control-plane variables

These configure the dashboard, API, database and control-plane defaults.

Prop

Type

Variables read by install.sh

Written into /opt/deplo/.env and read by docker compose --env-file. Set them before the install command.

Prop

Type

The installer also honours DEPLO_SKIP_NET_CHECKS=1, DEPLO_IMAGE, DEPLO_TRACE, DEPLO_LOG_FILE, and DEPLO_DIR. The agent installer accepts DEPLO_TRACE and DEPLO_LOG_FILE too.

Variables read by install-agent.sh

Set in front of install-agent.sh. See Server roles for what each role changes on the host.

Prop

Type

Before you change one

DEPLO_SECRET is permanent

Back up /opt/deplo/.env. See Disaster recovery.

  • DEPLO_SERVER_IP must be a real, internet-reachable address. Generated hostnames encode an IPv4 in hexadecimal and an IPv6 after v6-, so a private or loopback address produces URLs that only work from that machine.
  • A hostname in DEPLO_PUBLIC_URL cannot seed a deplo.site name, so Deplo falls through to interface detection for the IP. Set DEPLO_SERVER_IP explicitly on a multi-homed box.
  • DEPLO_DATA_DIR is staging, not storage. Nothing durable lives there.
  • Build-time placeholders exist in the Dockerfile for the database URL and the secret. They never reach the runtime image and are not usable values.

See also

Did this page help you?

On this page