NZBGet Docker Setup Guide

Provider reviews, pricing comparisons, and practical setup guidance.

Current Recommendations

Live from our provider database. This block stays synced across pages as rankings change.

  • NewsDemon Score: 9.4/10 • Backbone: UsenetExpress (independent) • Pricing: From $3/mo metered; $12.95/mo monthly unlimited; $7/mo quarterly; $6/mo annual
  • Frugal Usenet Score: 9.4/10 • Backbone: Netnews-linked hybrid + bonus path • Pricing: $5.99/mo; ~$60/yr bundles shown with block add-on
  • UsenetExpress Score: 9.3/10 • Backbone: UsenetExpress (independent) • Pricing: $10/mo, $90/yr, plus block options
Technical refresh: This article has been normalized for current Usenet workflows (provider reliability, retention/completion behavior, and modern client/indexer automation patterns).

NZBGet Docker Setup Guide

This guide walks through a clean NZBGet Docker setup for home servers and always-on boxes. We focus on stable paths, predictable permissions, secure defaults, and ARR-ready routing.

Goal: Launch NZBGet once, keep it persistent across reboots, and avoid path/permission problems that break imports later.

1. Prerequisites

  • Docker Engine + Docker Compose plugin installed.
  • A persistent storage location (SSD recommended for active queue).
  • Usenet provider credentials (host, username, password, SSL port 563).
  • Optional but recommended: Prowlarr + Sonarr/Radarr for automation.

2. Create Folder Structure

Use one root for all media apps so path mappings stay consistent.

mkdir -p /srv/media/nzbget/config
mkdir -p /srv/media/downloads/incomplete
mkdir -p /srv/media/downloads/complete
/srv/media/nzbget/config: NZBGet settings and runtime data.
/srv/media/downloads/incomplete: active jobs.
/srv/media/downloads/complete: completed output for ARR pickup.

3. Docker Compose (Recommended)

Create docker-compose.yml in a folder like /srv/media/nzbget/:

services:
  nzbget:
    image: lscr.io/linuxserver/nzbget:latest
    container_name: nzbget
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Chicago
      - NZBGET_USER=nzbget
      - NZBGET_PASS=change_this_now
    volumes:
      - /srv/media/nzbget/config:/config
      - /srv/media/downloads:/downloads
    ports:
      - "6789:6789"
    restart: unless-stopped

Important: Set PUID/PGID to the same user/group that own your media folders. Most "cannot import" errors are permission mismatches.

4. Start the Container

docker compose up -d
docker compose ps
docker compose logs -f nzbget

Open http://YOUR_HOST_IP:6789 and log in with the credentials you set in Compose.

5. Configure Provider Server Inside NZBGet

Step 1: Go to Settings > News-Servers.
Step 2: Enter provider host, username, and password.
Step 3: Set port to 563 and enable SSL.
Step 4: Start with moderate connections (for example 20-30), then tune upward.
Step 5: Run Test Connection and save.

6. Set Paths for ARR Compatibility

Under Settings > Paths:

  • MainDir: /downloads
  • DestDir: /downloads/complete
  • InterDir: /downloads/incomplete
  • NzbDir: optional watch folder if you use drop-in NZBs

Keep these identical across NZBGet and ARR container mappings to avoid remote path remap hacks.

7. Connect to ARR Stack

Prowlarr: add indexers once, sync to Sonarr/Radarr.
Sonarr/Radarr: add NZBGet as downloader with host/port/user/pass.
Categories: map category names in ARR and NZBGet so routing is deterministic.
Validation: send one test release and confirm it imports without manual intervention.

8. Hardening and Reliability

  • Change default credentials immediately.
  • Do not expose NZBGet directly to the open internet without a reverse proxy/auth layer.
  • Use restart: unless-stopped so reboots recover automatically.
  • Back up /config weekly (this preserves queue/settings).
  • Keep queue/history trimmed to avoid a sluggish UI on long-running instances.

9. Troubleshooting Quick Wins

Web UI won’t load: check port mapping and host firewall rules.
Articles fail consistently: verify host/port/SSL and provider credentials.
ARR won’t import: verify shared paths and ownership/permissions.
Slow downloads: tune connections gradually and test alternate provider ports.
Container exits: inspect docker compose logs -f nzbget for startup errors.

Related Guides

How to Use NZBGet · Usenet and NZB Management Guide · Best NZB Indexers