Upgrade

Read the Brokerr changelog for bootstrap, schema, SDK, auth, and provider changes.

Before upgrading

1. Cancel or finish active runs and bulk operations.
2. Record the current application and database schema versions from Diagnostics.
3. Stop Brokerr or use a SQLite-aware online backup.
4. Back up config.yml, the database, and the matching master key separately.
5. Confirm space for the new image and database migration.
6. Select an intended release commit or tag.

Update

docker compose down
git pull --ff-only
docker compose build --pull brokerr
docker compose up -d brokerr
docker compose logs -f brokerr

Verify

• login and Diagnostics;
• OAuth gateway and AniBridge dashboard checks;
• source/target connection tests and identity;
• profile scope, feature review state, baseline, and managed-list bindings;
• a dry incremental run for each enabled profile;
• Plex webhook delivery for an eligible test item.

Do not start live writes when a plugin SDK incompatibility, schema error, missing credential, or feature Needs review warning remains.

After verification, confirm that scheduler groups, profile schedule opt-ins, Discord notification scopes, and Plex webhooks resumed with the expected state.