Skip to content
BrokerrBrokerr

Initial setup

On a new database, sign in as admin with the one-time password written to /data/bootstrap_password:

Terminal window
docker compose exec brokerr sh -c 'cat /data/bootstrap_password'

The password file is created during startup. If creation fails, make the entire persistent tree writable by the configured non-root UID/GID. With the default local Compose user this may require:

Terminal window
sudo chown -R 1000:1000 data

Do not solve ownership problems by running the application as root.

Brokerr requires a permanent username and password. Saving it invalidates and removes the one-time credential.

First configuration

Section titled “First configuration”
  1. Set the externally reachable Public Base URL and trusted-proxy/host settings.
  2. Generate the webhook API key if Plex webhooks will be used.
  3. Open the dashboard and verify OAuth gateway and AniBridge health.
  4. Add and test one Plex source.
  5. Add and test one target.
  6. Create a profile, review its capability-resolved feature defaults, and save it.
  7. Run a full dry-run, fix unmatched mappings, then establish a live full baseline.

Runtime settings use row revisions. If another tab saved a newer revision, reload and reapply the intended edit instead of overwriting it.