Installation

Choose your preferred installation method to get Blockbusterr running.

Trusted LAN only

Blockbusterr has no built-in authentication and is intended for a trusted LAN. Do not expose port 9090 directly to the internet; use an authenticated reverse proxy or VPN for remote access.

Prerequisites

Docker

Docker 20.10+ or Docker Desktop

Storage

50GB+ recommended for database and logs

Network

Access to Trakt, TMDB, and your *arr stack

Installation Methods

Docker Run

Quickest way to get started - Single command deployment.

1. Pull the latest image:

   docker pull ghcr.io/mahcks/blockbusterr:latest

2. Run the container:

   docker run -d \
     --name blockbusterr \
     -p 9090:9090 \
     -v $(pwd)/data:/app/data \
     -e TZ=America/New_York \
     ghcr.io/mahcks/blockbusterr:latest

3. Access the web UI at http://localhost:9090

Tip

Use docker logs blockbusterr -f to view live logs and verify startup.

Docker Compose

Best for production - Easy management and restarts.

1. Create docker-compose.yaml:

   version: '3.8'
   
   services:
     blockbusterr:
       image: ghcr.io/mahcks/blockbusterr:latest
       container_name: blockbusterr
       ports:
         - "9090:9090"
       volumes:
         - ./data:/app/data
         - ./config:/app/config  # Optional: external config
       environment:
         - TZ=America/New_York
       restart: unless-stopped

2. Start the stack:

   docker-compose up -d

3. View logs:

   docker-compose logs -f blockbusterr

Note

The config volume is optional - you can configure everything through the web UI.

With Full Stack

Complete setup - Blockbusterr + Radarr + Sonarr on the same network.

version: '3.8'

networks:
  media:
    driver: bridge

services:
  blockbusterr:
    image: ghcr.io/mahcks/blockbusterr:latest
    container_name: blockbusterr
    networks:
      - media
    ports:
      - "9090:9090"
    volumes:
      - ./blockbusterr/data:/app/data
    environment:
      - TZ=America/New_York
    restart: unless-stopped

  radarr:
    image: linuxserver/radarr:latest
    container_name: radarr
    networks:
      - media
    ports:
      - "7878:7878"
    volumes:
      - ./radarr/config:/config
      - /path/to/movies:/movies
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
    restart: unless-stopped

  sonarr:
    image: linuxserver/sonarr:latest
    container_name: sonarr
    networks:
      - media
    ports:
      - "8989:8989"
    volumes:
      - ./sonarr/config:/config
      - /path/to/tv:/tv
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
    restart: unless-stopped

Caution

When using container networking, use container names in URLs:

• Radarr: http://radarr:7878
• Sonarr: http://sonarr:8989

Binary

For advanced users - Direct binary execution without Docker.

1. Download the latest release from GitHub Releases

2. Extract the archive:

   tar -xzf blockbusterr-linux-amd64.tar.gz
   cd blockbusterr

3. Make the binary executable:

   chmod +x blockbusterr

4. Run Blockbusterr:

   ./blockbusterr

Note

The binary expects config.yaml in the same directory or in ./config/.

From Source

For developers - Build from source code.

1. Clone the repository:

   git clone https://github.com/mahcks/blockbusterr.git
   cd blockbusterr

2. Install dependencies:

   go mod download

3. Build the binary:

   make build

4. Run Blockbusterr:

   ./bin/blockbusterr

Development mode with hot reload:

make dev

Environment Variables

Configure Blockbusterr behavior with environment variables:

Variable	Default	Description
CONFIG_PATH	config search paths	Directory containing the config file
DATA_DIR	./data	Database directory
DISABLE_UI	false	Disable the web UI when set to true, 1, or yes
VERSION	build metadata	Override displayed version metadata
COMMIT	build metadata	Override displayed commit metadata
TZ	UTC	Timezone for scheduling

Example with custom settings:

docker run -d \
  --name blockbusterr \
  -p 8080:9090 \
  -e DATA_DIR=/app/data \
  -e TZ=Europe/London \
  -v $(pwd)/data:/app/data \
  ghcr.io/mahcks/blockbusterr:latest

Health Check

Verify Blockbusterr is running correctly:

curl http://localhost:9090/v1/

Expected response:

{
  "version": "1.5.0",
  "uptime": "1785518792000"
}

Updating

Docker

docker pull ghcr.io/mahcks/blockbusterr:latest
docker stop blockbusterr
docker rm blockbusterr
# Then run the original docker run command

Docker Compose

docker-compose pull blockbusterr
docker-compose up -d blockbusterr

Binary/Source

Download the new release or pull the latest code:

git pull origin master
make build
./bin/blockbusterr

Backup Before Updating

Always backup your data directory before major version upgrades:

cp -r data data.backup

Troubleshooting

Port Already in Use

Change the port mapping: -p 8080:9090 (host:container)

Permission Denied

Ensure the data directory is owned and writable by the user running Blockbusterr.

Can't Connect to *arr

Use container names if on same Docker network, not localhost

Database Locked

Only run one Blockbusterr instance per data directory

Next Steps

Quick Start

Get up and running in 5 minutes

Configuration

Configure Trakt and your integrations

Set Up Jobs

Create automated content discovery jobs