Upgrade and Maintenance

Server Upgrade

Root users can check and upgrade stable Server releases from the console header. Manual binary upload is also supported.

Preview releases require manual selection. Stable releases are recommended for production.

Agent Upgrade

Agents follow stable releases by default. Preview upgrades must be triggered manually.

The install script can be re-run for reinstall or upgrade:

curl -fsSL https://raw.githubusercontent.com/Rain-kl/OpenFlare/main/scripts/install-agent.sh | bash -s -- \
  --server-url http://your-server:3000 \
  --agent-token YOUR_AGENT_TOKEN

Data Maintenance

The settings page controls observability cleanup:

Option	Description
DatabaseAutoCleanupEnabled	Enable daily cleanup
DatabaseAutoCleanupRetentionDays	Retention days, minimum 1

When enabled, Server cleans access logs, metric snapshots, and request reports at 03:00 every day.

Validation Commands

cd openflare_server
GOCACHE=/tmp/openflare-go-cache go test ./...

cd openflare_agent
GOCACHE=/tmp/openflare-go-cache go test ./...

cd openflare_server/web
pnpm build