Skip to content
BrokerrBrokerr

Requirements

Docker deployment

Section titled “Docker deployment”
  • Docker Engine with Compose v2.
  • A host directory for persistent /data storage.
  • One reachable Plex server and a Plex account.
  • At least one AniList, TMDB, or Letterboxd target account.
  • A modern browser.
  • HTTPS and a stable public URL for remote Plex webhooks and production access.

The Compose file builds Brokerr from the checkout. Plan space for image layers, SQLite run/history state, AniBridge data, source observations, exports, and artwork cache.

Source development

Section titled “Source development”
  • Python 3.12.
  • Node.js 22.12 or newer with npm.
  • Dependencies from backend/requirements.txt and frontend/package-lock.json.
  • Separate backend and Vite terminals.

Provider accounts

Section titled “Provider accounts”

Hosted authorization needs only the provider account. AniList and TMDB custom mode require an operator-owned provider application. Letterboxd API access is provided through the hosted gateway. Plex account Sync Watch State & Ratings is required only for optional connected-account recorded-history features.

Network access

Section titled “Network access”

Brokerr may need the selected Plex server, Plex account services, provider APIs, AniBridge mapping data, and https://auth.brokerr.net. Do not expose Brokerr or its data directory directly without TLS and a correctly configured reverse proxy.