selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Blockbusterr logo

Self-host Blockbusterr

v2.0.1

Automated media discovery with rule-based decisions

ReleaseOpen SourceMIT
Updatedlast month
LanguageGo
Setup difficultyModerate
Stars
154
Port
9090 (HTTP web UI and API)
Docker
ghcr.io/mahcks/blockbusterr
Install with Docker
A completed Blockbusterr job run showing its decision flow and media results

What is Blockbusterr?

Blockbusterr is an automated media discovery and decision layer for self-hosted media stacks. It connects to discovery providers like TMDB, Simkl, Trakt, MDBList, and Letterboxd to fetch trending, popular, anticipated, or watchlist content. Each candidate is evaluated against reusable rule sets that can filter by genre, language, country, year, rating, votes, keywords, networks, and runtime. The tool supports preview-first jobs to inspect decisions before enabling delivery, ranked selection cycles to share delivery slots across jobs, and delivery safeguards including budgets, repeat handling, and title exceptions. It delivers either to Radarr and Sonarr or via Jellyseerr/Seerr requests. All configuration, credentials, and SQLite history are stored in a single persistent data directory. The project is distributed as a single Docker image from ghcr.io/mahcks/blockbusterr with no required external database. It has no built-in authentication by default but supports an optional token for owner access.

Should you self-host Blockbusterr?

Blockbusterr scores 49/100 on selfhost.directory (how scoring works) and ranks #70 of 142 in Media Management. It has 154 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v2.0.1, came out on 13 September 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 472 stars). It scores higher overall, so compare the two before you pick. See Blockbusterr vs Sonarr side by side.

Features

  • Decision history
  • Delivery safeguards
  • Lists and watchlists
  • Portable configuration
  • Preview-first jobs
  • Ranked selection
  • Recipes and custom jobs
  • Reusable rules
  • Single-Container Deployment
  • Two delivery paths

Blockbusterr README

How to install Blockbusterr

Install Blockbusterr with Docker

Environment variables
TZ, BLOCKBUSTERR_AUTH_TOKEN, BLOCKBUSTERR_DRY_RUN, DATA_DIR, CONFIG_PATH, DISABLE_UI, VERSION, COMMIT

docker volume create blockbusterr-data

docker run -d
--name blockbusterr
--restart unless-stopped
-p 9090:9090
-v blockbusterr-data:/app/data
ghcr.io/mahcks/blockbusterr:v2.0.1

Open http://localhost:9090 after starting

How to configure Blockbusterr

  • BLOCKBUSTERR_AUTH_TOKENOptional owner token (at least 32 characters); sign in with username blockbusterr

    Optional owner token (at least 32 characters); sign in with username blockbusterr

    values: random string >= 32 chars

  • BLOCKBUSTERR_DRY_RUNfalseEvaluate jobs and record decisions without sending content to Radarr, Sonarr, Jellyseerr, or Seerr

    Evaluate jobs and record decisions without sending content to Radarr, Sonarr, Jellyseerr, or Seerr

    values: true, false

  • COMMITbuild metadataOverride displayed commit metadata

    Override displayed commit metadata

    values: string

  • CONFIG_PATHconfig search pathsDirectory containing the config file

    Directory containing the config file

    values: path

  • DATA_DIR./dataDatabase directory

    Database directory

    values: path

  • DISABLE_UIfalseDisable the web UI when set to true, 1, or yes

    Disable the web UI when set to true, 1, or yes

    values: true, false, 1, yes

  • TZUTCTimezone for scheduling

    Timezone for scheduling

    values: IANA timezone

  • VERSIONbuild metadataOverride displayed version metadata

    Override displayed version metadata

    values: string

Blockbusterr releases & version history

More in Media Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…