Agent configuration

The Reflex agent is configured primarily through the dashboard. Settings are synced to your server automatically — you rarely need to touch anything on the server itself.

Dashboard settings

The following settings are managed per-server in the Reflex dashboard under Server Settings.

Monitoring

• Metrics collection interval — How often the agent reports CPU, memory, disk, and process metrics
• Health check interval — How often the agent runs service health checks
• Log forwarding — Enable forwarding of system and application logs to the Reflex timeline

Playbooks

Enable or disable individual self-healing playbooks per server. Each playbook can be configured with:

• Trigger thresholds — When the playbook should activate
• Cooldown period — Minimum time between automated interventions
• Notification preferences — Who gets alerted when a playbook executes

Deployments

• Git repository — The repository to deploy from
• Branch — The branch to track
• Build commands — Commands to run during the build phase
• Release commands — Commands to run after a successful build (migrations, cache clearing, etc.)
• Health check URL — Endpoint to verify after deployment

Log levels

The agent log level can be changed temporarily for debugging via the dashboard. Available levels:

Level	Description
error	Critical failures only
warn	Warnings and errors
info	Normal operational messages (default)
debug	Verbose output for troubleshooting

Environment variables

Variable	Description
REFLEX_API_URL	Control plane URL (set automatically during installation)
REFLEX_TEAM_TOKEN	Team registration token (found in dashboard Settings)