Configuration

Configuration surfaces

• license-monitor/config.toml on each monitored server
• license-server-detail environment variables for auth, Convex, and API behavior
• Convex servers records for monitored host/IP, port, and optional API key metadata

License Monitor (host-side)

Key sections:

• [command_mode]: command, interval, parse script
• [tail_mode]: log file and regex parsing (if needed)
• [api]: bind, CORS, rate limits, websocket enablement
• [logs]: file and log levels
• [update]: self-update channel and repository settings

License Server Detail (web-side)

Required for production runtime:

• AUTH_OKTA_ID
• AUTH_OKTA_SECRET
• AUTH_OKTA_ISSUER
• AUTH_SECRET
• NEXT_PUBLIC_CONVEX_URL

Recommended:

• NEXTAUTH_URL
• NEXT_PUBLIC_LICENSE_MONITOR_URL
• LICENSE_MONITOR_API_KEY (optional in current code path)

Convex server records

For each monitored server, configure:

• Name / FQDN / IP
• Port (8080 unless changed)
• License server type and metadata
• Active flag and optional API key field

Change control

When changing monitor host/port, parser script, or auth values:

1. Apply change in staging
2. Verify /api/health and /api/licenses
3. Roll out to production
4. Confirm dashboard data freshness