Skip to content
Blockbusterr v2

Quick Start

Start the container

Section titled “Start the container”
Terminal window
docker run -d \
  --name blockbusterr \
  -p 9090:9090 \
  -v blockbusterr-data:/app/data \
  --restart unless-stopped \
  ghcr.io/mahcks/blockbusterr:latest-beta

Open http://localhost:9090. To enable owner authentication, add -e BLOCKBUSTERR_AUTH_TOKEN="replace-with-at-least-32-random-characters" and sign in as blockbusterr.

Configure the first pipeline

Section titled “Configure the first pipeline”

  1. Choose a discovery provider

    In Settings, configure at least one of TMDB, Simkl, Trakt, or MDBList. Only providers supported by a selected job type appear in the Jobs editor.

  2. Choose delivery

    Configure Radarr for direct movie delivery, Sonarr for direct show delivery, or Jellyseerr/Seerr for request-based delivery. Test the connection and load any required profiles or root folders.

  3. Save Settings

    Correct any validation errors before leaving the page. Credentials are stored in your local configuration; protect the mounted data directory.

  4. Create a job

    Open Jobs, choose New job, then select a ready recipe. Blockbusterr creates it disabled with dedicated rules and opens Preview immediately. Use Custom Job when you need a combination outside the recipe catalog.

  5. Review Rules

    Default Movies and Default Shows are created automatically. Edit the appropriate default or create a reusable rule set for this job. Use a job-specific copy when only one job should change.

  6. Preview

    Open the job and select Preview. Review accepted, rejected, skipped, and already-present titles. Decision details identify the exact rule or delivery check involved.

  7. Enable and run

    Save the job, enable it, and use Run now for the first live execution.

  8. Verify Activity

    Use Activity Entries for title-level outcomes and Job Runs for found, passed, delivered, rejected, skipped, and failed totals.

Section titled “Recommended first setup”
  • One TMDB or Simkl Trending Movies job
  • Default Movies rules with a language and reasonable year/rating boundary
  • Jellyseerr/Seerr mode if you want approval before download
  • A manual preview and one live run before relying on the schedule

Next steps

Section titled “Next steps”