General settings
Public Base URL
Section titled “Public Base URL”Enter the externally reachable origin, for example https://brokerr.example.com
or http://192.0.2.10:8080. Do not include a path. Brokerr uses this value for
custom OAuth callback URLs and displayed source webhook links.
Safety defaults
Section titled “Safety defaults”- Dry-run default controls newly initiated manual/profile runs unless the run overrides it.
- Webhook dry-run default protects event-triggered runs independently.
- Request pacing defaults supply interval, retry attempts, and retry delay to targets that do not override them.
Provider-specific pacing defaults take precedence over global target defaults; an individual target can override its provider defaults.
Source artwork
Section titled “Source artwork”Cache source thumbnails stores posters lazily and shares them across media
with the same stable identifier. Thumbnail TTL days controls refresh and
cleanup; 0 keeps cached files indefinitely. The cache summary and cleanup
button affect only rebuildable thumbnail files, not run history.
API key
Section titled “API key”Brokerr maintains one instance API key. Reveal it only to configure an integration such as Plex webhooks. Regeneration immediately invalidates the old key and all URLs that contain it.
The UI displays creation and throttled last-used timestamps without logging the key. Browser authentication continues to use the signed session cookie, not the API key.