Quickstart

Get AniBridge running in minutes. Pick one of the methods below.

Video walkthrough

Legal & Ethics

Read the short Legal Disclaimer before continuing. AniBridge does not host or provide content. You are responsible for compliance with laws and site terms in your jurisdiction.

Option A — Docker (recommended)

The simplest and most reliable way to run AniBridge.

Minimal Compose

services:
  anibridge:
    image: ghcr.io/zzackllack/anibridge:latest
    container_name: anibridge
    ports:
      - "8000:8000"   # host:container
    environment:
      - QBIT_PUBLIC_SAVE_PATH=/downloads
    volumes:
      - ./downloads:/data/downloads   # host path → container path
      - ./data:/data                        # DB, logs

Verify:

docker compose up -d
curl -sS http://localhost:8000/health
# {"status":"ok"}

Sonarr/Prowlarr URLs

• Torznab: http://anibridge:8000/torznab/api
• qBittorrent base: http://anibridge:8000/

With Gluetun (VPN sidecar)

Recommended for privacy and stability. AniBridge shares the VPN network namespace and is exposed via Gluetun’s port mapping.

services:
  gluetun:
    image: qmcgaw/gluetun:latest
    container_name: gluetun
    cap_add: ["NET_ADMIN"]
    ports:
      - "8000:8000/tcp"   # expose AniBridge through the VPN container
    environment:
      # Fill according to the Gluetun docs for your provider
      - VPN_SERVICE_PROVIDER=custom     # or your provider name
      - VPN_TYPE=wireguard              # or openvpn
      - WIREGUARD_PRIVATE_KEY=...       # required for WireGuard
      - WIREGUARD_ADDRESSES=10.64.0.2/32
      # - SERVER_COUNTRIES=...         # example for provider selection

  anibridge:
    image: ghcr.io/zzackllack/anibridge:latest
    container_name: anibridge
    network_mode: "service:gluetun"   # route all traffic via Gluetun
    environment:
      - QBIT_PUBLIC_SAVE_PATH=/downloads
    volumes:
      - ./downloads:/data/downloads
      - ./data:/data

Port collisions inside VPN namespace

When multiple apps share Gluetun’s network, each must listen on a unique internal port. AniBridge defaults to 8000. If you need a different port, set ANIBRIDGE_PORT and map the same port on the Gluetun service.

Option B — Bare metal (prebuilt releases)

Download the binary for your OS/arch from GitHub Releases and run it.

# macOS (Apple Silicon example)
curl -L -o anibridge.tar.gz \
  "https://github.com/zzackllack/AniBridge/releases/latest/download/anibridge-macos-arm64.tar.gz"
tar -xzf anibridge.tar.gz && chmod +x anibridge
./anibridge

Place a .env file next to the binary if you need to customize paths. See Environment.

Option C — Python (from source)

uv

uv sync --frozen
uv run python -m app.main

The API listens on http://localhost:8000.

Next Steps

• Configure Prowlarr (Torznab): http://localhost:8000/torznab/api
• Configure Sonarr (qBittorrent): http://localhost:8000/
• Browse Environment for available settings
• See Integrations → Sonarr, Integrations → Radarr and Integrations → Prowlarr for setup guides