Environment variables¶
All optional, all off by default — forest is silent and sends nothing
anywhere unless configured. Copy .env.example in the repository for a
commented template.
Logging¶
Logs are always secret-scrubbed (keys, tokens, URL credentials are redacted).
| Variable | Default | Effect |
|---|---|---|
FOREST_LOG_FILE |
unset | Append structured logs (JSON lines) to this file. |
FOREST_LOG_FORMAT |
json |
json or text; set without FOREST_LOG_FILE to log to stderr. |
FOREST_LOG_LEVEL |
INFO |
Standard logging level name. |
Transfer resilience¶
| Variable | Default | Effect |
|---|---|---|
FOREST_TRANSFER_RETRIES |
2 |
Extra attempts for transient rclone failures; 0 disables. |
FOREST_RETRY_BASE_DELAY |
0.5 |
Initial retry backoff in seconds; doubles per attempt. |