- Get Started

Configuration Reference

OpenFlows has no public environment-variable reference — that is internal detail. What matters to you are the knobs you actually set, grouped here by concern. Almost everything is changeable from the control panel without a restart. Platform-level items (which models are available, centrally managed tools) are configured in the Coder dashboard.

Team configuration

Each agent role — FORGE, SENTINEL, VESSEL, and LORE — is configured from the control panel. The same settings apply regardless of role:

SettingWhat it controls
Worker countHow many agents a role may run at once — its ceiling on concurrency.
ModelWhich model the role uses.
Plan modeWhether the role must get approval before acting.
SkillsWhich packaged capabilities the role can use.
External toolsWhich outside tools the role can call.

A guardrail on changes

A change can’t silently drive a role to zero workers. Anything that would leave a role with no available agents is rejected.

Fleet steering

SettingEffect
PauseLet in-flight work finish; don’t pick up new work.
DrainStop taking on new tickets.
TargetFocus on a specific repository, issue, or label.
Resume / normalReturn to ordinary operation.

Steering changes how the fleet picks up and processes work without requiring a restart — you can pause, drain, or refocus the team on the fly.

Platform-level settings

These live in the Coder dashboard rather than in OpenFlows itself, because they govern the shared environment all teams run on:

SettingWhat it controls
Models availableThe catalog of models roles can reference.
Central toolsTeam-wide tools with allow and deny lists and availability.
Identity / single sign-onWho can reach the environment and its workspaces.
AuditThe platform audit log.

Notifications

ChannelWhat you set
SlackA webhook URL.
DiscordA webhook URL.
WhatsAppCredentials and sending/destination phone numbers.

Each channel is configured independently, and any combination can be enabled. See the Notifications Reference for how they behave.

Environment & topology

These are decided at install time and describe how your deployment is put together:

PieceWhat it provides
Coder server locationWhere the control plane is.
Coordination storeThe shared record of truth that tracks all team state.
DatabaseCoder’s own data store.
Repository bindingThe repository a tenant works on.

Core behaviors you generally don’t change

Some things are deliberate design decisions rather than toggles:

Related