Sign inSign up

diverdale/binarr

By diverdale

•Updated 1 day ago

Self-hosted Usenet downloader with modern web UI. SABnzbd-compatible, works with Sonarr & Radarr.

Image
1

1.8K

diverdale/binarr repository overview

⁠Binarr

A modern, self-hosted Usenet downloader with a clean web UI and SABnzbd API compatibility.


⁠Features

  • Multi-server Usenet — priority-ordered server failover, TLS support, configurable connection pools
  • SABnzbd API compatibility — works out of the box with Sonarr, Radarr, and other *arr apps
  • Full post-processing pipeline — PAR2 verification & repair, RAR/7z extraction, per-category scripts
  • NZB ingestion — drag & drop, URL add, watched folder, or RSS feeds
  • Download scheduling — time windows and day-of-week restrictions
  • Notifications — webhook, Apprise, and Prowl support
  • Live web UI — real-time speed graph, queue management, download history, dark theme

⁠Quick Start

services:
  binarr:
    image: diverdale/binarr:latest
    container_name: binarr
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./config:/config
      - /your/downloads:/downloads
    environment:
      - TZ=America/New_York

Then open http://localhost:8080 — the onboarding wizard will guide you through adding your first Usenet server.


⁠Volumes

PathPurpose
/configConfig file (config.toml) and SQLite database
/downloadsCompleted downloads and temp working directory

⁠Environment Variables

VariableDefaultDescription
TZUTCTimezone for scheduling and timestamps
BINARR_COMPLETED_DIR/downloads/completeWhere finished downloads land
BINARR_TEMP_DIR/downloads/tempWorking directory during download/extraction

⁠Sonarr / Radarr Setup

Add Binarr as a SABnzbd download client:

FieldValue
Hostyour Binarr host
Port8080
API Keyvalue from Binarr → Settings → General
Categorymatch your Sonarr/Radarr category name

Tag summary

Content type

Image

Digest

sha256:f1a300714…

Size

12.8 MB

Last updated

1 day ago

docker pull diverdale/binarr