Reference

Configuration

Environment variables, config files, and runtime settings for OpenRig.

Environment Variables

OpenRig reads the following environment variables at startup:

OPENRIG_PORTdefault: 7433

The port the OpenRig daemon listens on for API and dashboard connections.

OPENRIG_HOSTdefault: localhost

The host address the daemon binds to.

OPENRIG_DBdefault: ~/.openrig/state.db

Path to the SQLite database used for rig state, snapshots, and memory.

Config File Locations

OpenRig stores configuration and state in the ~/.openrig/ directory:

~/.openrig/
  config.yaml      # Global CLI configuration
  state.db         # Rig state and snapshots
  memory/          # Externalized agent memory
  specs/           # Cached AgentSpecs and RigSpecs

Detailed configuration reference coming soon.