Installation

Choose your preferred installation method to get Blockbusterr running.

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
PORT	9090	HTTP server port
CONFIG_PATH	./config/config.yaml	Path to config file
DATA_PATH	./data	Path to database directory
LOG_LEVEL	info	Logging level (debug, info, warn, error)
TZ	UTC	Timezone for scheduling

Example with custom settings:

docker run -d \
  --name blockbusterr \
  -p 8080:8080 \
  -e PORT=8080 \
  -e LOG_LEVEL=debug \
  -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/api/v1/health

Expected response:

{
  "status": "healthy",
  "version": "1.0.0",
  "uptime": "2h34m12s"
}

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 writable: chmod -R 777 data/

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