# SABnzbd Usenet Downloader

> Open source binary newsreader with automation features.

- Category: Media & Entertainment
- Difficulty: beginner
- Components: sabnzbd
- Tags: usenet, sabnzbd, download, nzb, automation
- Source: https://docker.recipes/media/sabnzbd-nzbget

## Overview

SABnzbd is a mature, open-source binary newsreader designed specifically for automated Usenet downloading. Developed in Python and maintained since 2007, SABnzbd excels at processing NZB files, managing download queues, and automatically handling post-processing tasks like verification, repair, and extraction. Unlike traditional newsreaders that require manual intervention, SABnzbd operates as a background service with a web-based interface, making it ideal for automated media acquisition workflows.

This Docker configuration deploys SABnzbd as a containerized service with proper volume mappings for download management and configuration persistence. The setup separates incomplete downloads from completed files, enabling efficient disk usage and reducing corruption risks during the download process. The LinuxServer.io image includes automatic updates and optimized runtime configurations that ensure stable operation across different host systems.

Home media enthusiasts and content collectors benefit most from this deployment, particularly those running automated media centers with Sonarr, Radarr, or similar applications. The containerized approach eliminates dependency conflicts while providing consistent performance, making SABnzbd accessible to users who want professional-grade Usenet downloading without complex system administration. The web interface design allows remote management, perfect for headless servers or NAS devices running in closets or basements.

## Features

- Multi-server Usenet connection support with SSL/TLS encryption and automatic failover
- Integrated PAR2 verification and repair with automatic damaged file recovery
- Queue-based download management with priority controls and bandwidth throttling
- Category-based post-processing with customizable scripts and folder organization
- RESTful API for integration with Sonarr, Radarr, Lidarr, and other automation tools
- RSS feed monitoring for automatic NZB acquisition from indexers
- Password-protected archive extraction supporting ZIP, RAR, and 7-Zip formats
- Comprehensive logging system with download history and performance statistics

## Use cases

- Automated TV show and movie downloading integrated with Plex or Jellyfin media servers
- High-volume software distribution for development teams requiring fast, reliable downloads
- Podcast and audiobook collection management with automatic organization and metadata handling
- Digital magazine and publication archiving for libraries or research institutions
- Backup retrieval system for large datasets stored on Usenet as backup medium
- Content aggregation for digital forensics teams requiring specific file recovery
- Academic paper and research document collection with automated categorization

## Prerequisites

- Active Usenet provider subscription with server details and authentication credentials
- Minimum 2GB RAM for handling large files and concurrent downloads efficiently
- At least 10GB free disk space for temporary files during download and extraction processes
- Port 8080 available on host system for web interface access and API communication
- NZB indexer access or manual NZB files for initiating downloads
- Basic understanding of Usenet concepts including retention, completion, and server hierarchies

## docker-compose.yml

```yaml
services:
  sabnzbd:
    image: lscr.io/linuxserver/sabnzbd:latest
    container_name: sabnzbd
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
    volumes:
      - sabnzbd-config:/config
      - /path/to/downloads:/downloads
      - /path/to/incomplete:/incomplete
    ports:
      - "8080:8080"
    networks:
      - sabnzbd-network
    restart: unless-stopped

volumes:
  sabnzbd-config:

networks:
  sabnzbd-network:
    driver: bridge
```

## .env

```bash
# SABnzbd
# Change paths to your directories
```

## Usage notes

- Web UI at http://localhost:8080
- Complete setup wizard
- Add Usenet server details
- Integrates with Sonarr/Radarr
- Category-based sorting

## Troubleshooting

- Download stalls at 99%: Check PAR2 files availability and run manual verification through web interface
- Connection failures with SSL errors: Verify Usenet provider SSL certificate settings and disable SSL if provider doesn't support it
- Extraction fails with password errors: Ensure NZB source provides correct passwords or configure automatic password detection
- High memory usage during large downloads: Increase article cache size or reduce concurrent connections in server settings
- Web interface shows 'Cannot connect to server': Restart container and verify network configuration isn't blocking port 8080
- Downloads complete but files missing: Check post-processing scripts and verify download folder permissions match PUID/PGID settings

