Configuration
Environment variables and configuration options for DorkOS
Configuration
DorkOS is configured via environment variables and a persistent config file at ~/.dork/config.json. CLI flags take highest precedence; built-in defaults apply when nothing else is set.
Config precedence: CLI flags > environment variables > ~/.dork/config.json > built-in
defaults.
Required
Prop
Type
Optional
Prop
Type
Tunnel Configuration
DorkOS supports ngrok tunnels for remote access from any device. See the Tunnel Setup guide for full details.
Prop
Type
Always set TUNNEL_AUTH when exposing DorkOS publicly via a tunnel. Without it, anyone with the
tunnel URL can access your sessions.
Relay Configuration
Relay is the messaging layer that lets agents reach you on Telegram, notify each other, and connect to external channels. See the Relay Messaging guide for setup details.
Prop
Type
Tasks Configuration
Tasks schedules agent jobs on a cron — independently, without keeping a terminal open. See the Task Scheduler guide for setup details.
Prop
Type
A2A Gateway
The A2A gateway exposes your DorkOS agents to external A2A-compatible clients (other agent frameworks, orchestrators, or tools that speak Google's Agent-to-Agent protocol). Requires Relay to be enabled.
Prop
Type
Mesh
Mesh is always on. It scans your projects for agent-capable directories and builds a discoverable registry without any additional configuration. See the Agent Discovery guide for details on registration and access control.
Config Directory
DorkOS creates ~/.dork/ on startup for configuration and state storage. Structured logs are written to ~/.dork/logs/dorkos.log as NDJSON.
Use dorkos config path to print the path to your config file, and dorkos config list to view all active settings.