Skip to content

Environment variables

Variable Effect
DRE_PROFILES_DIR Directory holding profiles.yml (default: the project directory if it has one, else ~/.dre). --profiles-dir overrides it.
DRE_PLUGINS_DIR One plugins directory for every project, instead of each project’s dre_deps/plugins.
DRE_REGISTRY_URL The plugin package registry index (a URL or a local path).
DRE_TARGET_PATH Where DRE writes its generated files (default: target/ in the project). --target-path overrides it; it overrides target_path: in dre_project.yml.
GITHUB_TOKEN Sent to GitHub by dre system update and github: plugin sources (private repositories, rate limits).
DRE_GITHUB_API_URL The GitHub API for github: plugin sources and dre system update (GitHub Enterprise, a mirror).
DRE_RUN_DATE The run date (YYYY-MM-DD) behind run.date, instead of today. It wins over DRE_RUN_AT’s date.
DRE_RUN_AT The instant a run was scheduled for (RFC 3339, e.g. 2026-09-01T06:00:00Z). It becomes run.now and run.scheduled_at, gives run.date (that instant’s date in the run’s timezone) when DRE_RUN_DATE isn’t set, and is recorded as scheduled_at in run_results.json. dre schedule ls puts it in every occurrence’s command.
DRE_TIMEZONE The run’s timezone (IANA name), above every timezone: setting. --timezone overrides it.
DRE_LOG_MAX_LINES Lines per logs/dre.log before it rotates (default 10,000).
DRE_PLUGIN_HANDSHAKE_TIMEOUT_MS How long to wait for a plugin to start (default 30,000).
NO_COLOR Turns off coloured output.
DRE_SECRET_* Values are masked as ***** in the console, logs, JSON events, run_results.json and target/compiled/ (mask_secrets: false in dre_project.yml turns this off).