tonym/NastyNAS
1
0
Fork 0
Code Issues 70 Pull Requests Actions Packages Projects Releases Wiki Activity

Configure SABnzbd Download Client #24

New Issue
Open
opened 2025-09-14 08:09:55 +00:00 by tonym · 0 comments
tonym commented 2025-09-14 08:09:55 +00:00
Owner
Copy Link

SABnzbd Configuration for Unraid 7.0.1

🚨 CRITICAL FIX: Download Removal Issue

Problem: SABnzbd is removing completed downloads before Sonarr/Radarr can import them.

Solution: Configure SABnzbd to keep completed downloads until imported.

Fix Steps:

  1. Access SABnzbd WebUI: http://[server-ip]:8080

  2. Go to Settings → Folders

  3. Completed Download Folder: Set to /downloads/complete

  4. Go to Settings → Switches

  5. Set these critical settings:

    • Post-Process Only Verified Jobs: ✅ Enabled
    • Action when encrypted RAR is downloaded: Abort
    • Action when duplicate NZB is detected: Discard
    • Cleanup List: ✅ Enabled (but see retention below)

  6. Go to Settings → Special

  7. Retention Settings:

    • Max retention: 7d (keep downloads for 7 days)
    • Cleanup List: Remove after 7 days (not immediately)

  8. Categories Configuration (CRITICAL):

    • Create categories BEFORE connecting arr apps
    • tv-sonarr: Folder = tv, No post-processing script
    • movies-radarr: Folder = movies, No post-processing script
    • music-lidarr: Folder = music, No post-processing script

Container Installation

From Community Applications

  1. Open Unraid WebUI → Apps tab
  2. Search for "SABnzbd" by linuxserver
  3. Click Install

Container Configuration

Basic Settings:

  • Port: 8080 (WebUI)
  • Network: bridge
  • Repository: linuxserver/sabnzbd

Volume Mappings:

/mnt/cache/appdata/sabnzbd → /config
/mnt/user/downloads → /downloads
/mnt/user/downloads/incomplete → /incomplete-downloads

Environment Variables:

PUID=99
PGID=100
TZ=America/Chicago
UMASK=002

Initial Configuration

1. First Access

2. Usenet Server Configuration

  • Settings → Servers
  • Add your usenet provider:
    • Server name
    • Host/port
    • Username/password
    • SSL encryption (recommended)
    • Connections (typically 10-20)

3. Critical Folder Configuration

  • Settings → Folders
  • Temporary Download Folder: /incomplete-downloads
  • Completed Download Folder: /downloads/complete
  • Watched Folder: /downloads/watched

4. Categories Setup (DO THIS FIRST)

Create these categories BEFORE connecting arr apps:

tv-sonarr Category

  • Name: tv-sonarr
  • Folder/Path: tv
  • Processing: Default
  • Priority: Normal
  • Post-processing script: None

movies-radarr Category

  • Name: movies-radarr
  • Folder/Path: movies
  • Processing: Default
  • Priority: Normal
  • Post-processing script: None

music-lidarr Category

  • Name: music-lidarr
  • Folder/Path: music
  • Processing: Default
  • Priority: Normal
  • Post-processing script: None

5. Download Settings

  • Settings → Switches
  • Download folder: /downloads/complete
  • Check before download: ✅ Enabled
  • Abort jobs that cannot be completed: ✅ Enabled
  • Pre-queue script: None
  • Max retention: 7d (keeps files for arr apps to import)

6. Post-Processing Settings

  • Settings → Switches
  • Enable processing: ✅ Enabled
  • Delete sample files: ✅ Enabled
  • Enable SFV-based checks: ✅ Enabled
  • Enable recursive unpacking: ✅ Enabled
  • Ignore password protected RARs: ✅ Enabled

Integration with Arr Applications

Connection Details for Arr Apps

  • Host: sabnzbd (container name) or server IP
  • Port: 8080
  • API Key: Found in Settings → General → API Key
  • Username/Password: Admin credentials you set

Categories Must Match Exactly

  • Sonarr: Use category tv-sonarr
  • Radarr: Use category movies-radarr
  • Lidarr: Use category music-lidarr

File Structure After Fix

/downloads/
├── complete/
│   ├── tv/           # Sonarr downloads here
│   ├── movies/       # Radarr downloads here
│   └── music/        # Lidarr downloads here
├── incomplete/       # Active downloads
└── watched/          # Watch folder for manual adds

Testing the Fix

1. Test Download

  1. Add a small NZB manually
  2. Verify it downloads to correct category folder
  3. Check that it stays in /downloads/complete/[category]
  4. Verify arr app can see and import it

2. Test Arr Integration

  1. Search for content in Sonarr/Radarr
  2. Monitor download progress in SABnzbd
  3. Verify file appears in correct category folder
  4. Confirm arr app imports successfully
  5. Check that file remains available for hardlink

Troubleshooting

Downloads Disappearing

  • Check retention settings (should be 7+ days)
  • Verify categories are configured correctly
  • Ensure completed folder is set properly
  • Check that cleanup is not too aggressive

Permission Issues

chown -R nobody:users /mnt/user/downloads
chmod -R 755 /mnt/user/downloads

Failed Imports

  • Verify hardlink capability between cache and array
  • Check that both SABnzbd and arr apps use same paths
  • Ensure PUID/PGID match across all containers

API Connection Issues

  • Verify API key is correct (no spaces)
  • Check that SABnzbd is accessible from arr containers
  • Test connection using container names vs IP addresses

Monitoring & Notifications

Uptime Kuma Integration

SABnzbd Notifications

  • Settings → Notifications
  • Configure for:
    • Download complete
    • Download failed
    • Disk full warning

Backup Configuration

Kopia Integration

  • Backup path: /mnt/cache/appdata/sabnzbd
  • Schedule: Daily incremental
  • Include: Configuration files, API keys, server settings

Critical Files

  • sabnzbd.ini - Main configuration
  • Categories configuration
  • Server configurations

Maintenance

Regular Tasks

  • Monitor disk space usage
  • Clean up old incomplete downloads
  • Update usenet server settings if needed
  • Review download statistics

Performance Optimization

  • Adjust connection limits based on provider
  • Monitor CPU usage during unpacking
  • Configure article cache size appropriately
  • Set appropriate cleanup intervals

Dependencies: Usenet provider account
Integration: Sonarr, Radarr, Lidarr, Prowlarr
Monitoring: Uptime Kuma
Backup: Kopia

⚠️ IMPORTANT: Always create categories FIRST, then connect arr applications!

# SABnzbd Configuration for Unraid 7.0.1 ## 🚨 CRITICAL FIX: Download Removal Issue **Problem:** SABnzbd is removing completed downloads before Sonarr/Radarr can import them. **Solution:** Configure SABnzbd to keep completed downloads until imported. ### Fix Steps: 1. **Access SABnzbd WebUI:** http://[server-ip]:8080 2. **Go to Settings → Folders** 3. **Completed Download Folder:** Set to `/downloads/complete` 4. **Go to Settings → Switches** 5. **Set these critical settings:** - **Post-Process Only Verified Jobs:** ✅ Enabled - **Action when encrypted RAR is downloaded:** Abort - **Action when duplicate NZB is detected:** Discard - **Cleanup List:** ✅ Enabled (but see retention below) 6. **Go to Settings → Special** 7. **Retention Settings:** - **Max retention:** 7d (keep downloads for 7 days) - **Cleanup List:** Remove after 7 days (not immediately) 8. **Categories Configuration (CRITICAL):** - Create categories BEFORE connecting arr apps - **tv-sonarr:** Folder = `tv`, No post-processing script - **movies-radarr:** Folder = `movies`, No post-processing script - **music-lidarr:** Folder = `music`, No post-processing script --- ## Container Installation ### From Community Applications 1. Open Unraid WebUI → Apps tab 2. Search for "SABnzbd" by linuxserver 3. Click Install ### Container Configuration **Basic Settings:** - **Port:** 8080 (WebUI) - **Network:** bridge - **Repository:** linuxserver/sabnzbd **Volume Mappings:** ``` /mnt/cache/appdata/sabnzbd → /config /mnt/user/downloads → /downloads /mnt/user/downloads/incomplete → /incomplete-downloads ``` **Environment Variables:** ``` PUID=99 PGID=100 TZ=America/Chicago UMASK=002 ``` ## Initial Configuration ### 1. First Access - Navigate to http://[server-ip]:8080 - Complete setup wizard - Set admin username/password ### 2. Usenet Server Configuration - **Settings → Servers** - Add your usenet provider: - Server name - Host/port - Username/password - SSL encryption (recommended) - Connections (typically 10-20) ### 3. Critical Folder Configuration - **Settings → Folders** - **Temporary Download Folder:** `/incomplete-downloads` - **Completed Download Folder:** `/downloads/complete` - **Watched Folder:** `/downloads/watched` ### 4. Categories Setup (DO THIS FIRST) **Create these categories BEFORE connecting arr apps:** #### tv-sonarr Category - **Name:** tv-sonarr - **Folder/Path:** tv - **Processing:** Default - **Priority:** Normal - **Post-processing script:** None #### movies-radarr Category - **Name:** movies-radarr - **Folder/Path:** movies - **Processing:** Default - **Priority:** Normal - **Post-processing script:** None #### music-lidarr Category - **Name:** music-lidarr - **Folder/Path:** music - **Processing:** Default - **Priority:** Normal - **Post-processing script:** None ### 5. Download Settings - **Settings → Switches** - **Download folder:** `/downloads/complete` - **Check before download:** ✅ Enabled - **Abort jobs that cannot be completed:** ✅ Enabled - **Pre-queue script:** None - **Max retention:** 7d (keeps files for arr apps to import) ### 6. Post-Processing Settings - **Settings → Switches** - **Enable processing:** ✅ Enabled - **Delete sample files:** ✅ Enabled - **Enable SFV-based checks:** ✅ Enabled - **Enable recursive unpacking:** ✅ Enabled - **Ignore password protected RARs:** ✅ Enabled ## Integration with Arr Applications ### Connection Details for Arr Apps - **Host:** sabnzbd (container name) or server IP - **Port:** 8080 - **API Key:** Found in Settings → General → API Key - **Username/Password:** Admin credentials you set ### Categories Must Match Exactly - Sonarr: Use category `tv-sonarr` - Radarr: Use category `movies-radarr` - Lidarr: Use category `music-lidarr` ## File Structure After Fix ``` /downloads/ ├── complete/ │ ├── tv/ # Sonarr downloads here │ ├── movies/ # Radarr downloads here │ └── music/ # Lidarr downloads here ├── incomplete/ # Active downloads └── watched/ # Watch folder for manual adds ``` ## Testing the Fix ### 1. Test Download 1. Add a small NZB manually 2. Verify it downloads to correct category folder 3. Check that it stays in `/downloads/complete/[category]` 4. Verify arr app can see and import it ### 2. Test Arr Integration 1. Search for content in Sonarr/Radarr 2. Monitor download progress in SABnzbd 3. Verify file appears in correct category folder 4. Confirm arr app imports successfully 5. Check that file remains available for hardlink ## Troubleshooting ### Downloads Disappearing - Check retention settings (should be 7+ days) - Verify categories are configured correctly - Ensure completed folder is set properly - Check that cleanup is not too aggressive ### Permission Issues ```bash chown -R nobody:users /mnt/user/downloads chmod -R 755 /mnt/user/downloads ``` ### Failed Imports - Verify hardlink capability between cache and array - Check that both SABnzbd and arr apps use same paths - Ensure PUID/PGID match across all containers ### API Connection Issues - Verify API key is correct (no spaces) - Check that SABnzbd is accessible from arr containers - Test connection using container names vs IP addresses ## Monitoring & Notifications ### Uptime Kuma Integration - Monitor: http://[server]:8080 - Check interval: 60 seconds - Alert on downtime ### SABnzbd Notifications - **Settings → Notifications** - Configure for: - Download complete - Download failed - Disk full warning ## Backup Configuration ### Kopia Integration - Backup path: `/mnt/cache/appdata/sabnzbd` - Schedule: Daily incremental - Include: Configuration files, API keys, server settings ### Critical Files - `sabnzbd.ini` - Main configuration - Categories configuration - Server configurations ## Maintenance ### Regular Tasks - Monitor disk space usage - Clean up old incomplete downloads - Update usenet server settings if needed - Review download statistics ### Performance Optimization - Adjust connection limits based on provider - Monitor CPU usage during unpacking - Configure article cache size appropriately - Set appropriate cleanup intervals --- **Dependencies:** Usenet provider account **Integration:** Sonarr, Radarr, Lidarr, Prowlarr **Monitoring:** Uptime Kuma **Backup:** Kopia **⚠️ IMPORTANT:** Always create categories FIRST, then connect arr applications!
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
tonym
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tonym/NastyNAS#24
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?