wiki/Catalogue-Self-Hosted/apps/app-nzbget.md

---
title: NZBGet
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, downloads, usenet, nzb, cpp, binary, headless]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=downloads, https://github.com/nzbgetcom/nzbget]
---

# 📰 NZBGet

> **Le téléchargeur Usenet historique écrit en C++** : extrêmement léger, rapide, multi-plateforme. Le compagnon idéal de Sonarr/Radarr/Lidarr pour **récupérer en NZB depuis Usenet**, décompresser, vérifier par2, et ranger dans votre bibliothèque.

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | [https://nzbget.com](https://nzbget.com) |
| **GitHub** | [https://github.com/nzbgetcom/nzbget](https://github.com/nzbgetcom/nzbget) |
| **License** | GPL-2.0 |
| **Langage** | C++ |
| **Étoiles** | 46 ⭐ (mirror principal : sourceforge) |
| **Dernière MAJ** | 2025-12 |
| **Catégorie** | [[cat-downloads\|Downloads]] |

## Description

**NZBGet** est l'un des **deux téléchargeurs Usenet de référence** (avec SABnzbd), créé en 2004, écrit en **C++ optimisé** pour une consommation mémoire et CPU minimale — il tourne sans broncher sur un NAS Synology d'entrée de gamme, un Raspberry Pi, ou un NUC modeste. Sa philosophie : faire **très bien une seule chose** (télécharger des NZB depuis Usenet, décompresser, vérifier, ranger), avec une **UI web moderne** pour piloter le tout.

L'architecture est volontairement simple : un **daemon headless** (peut tourner en service systemd, en container Docker, sur routeur OpenWrt…) qui télécharge les **articles binaires** Usenet (protocole NNTP), les réassemble, applique **par2** pour corriger les erreurs réseau, **décompresse** (RAR, 7z), et **déplace** dans la destination configurée. Le **scheduler** intégré permet de limiter la bande passante (utile la journée, full-speed la nuit), et le **scripting post-process** permet de déclencher des actions après import (ex. rafraîchir Jellyfin).

NZBGet est un **download client natif** dans **Sonarr, Radarr, Lidarr, Readarr, Whisparr** : les *arr s'y connectent via API, poussent un NZB récupéré depuis Prowlarr/Jackett, NZBGet le télécharge, et *arr l'importe automatiquement dans la bibliothèque. C'est la **colonne vertébrale** d'un setup *arr+Usenet classique. L'**API JSON-RPC** est stable depuis 10 ans, les extensions tierces (subliminal pour sous-titres, Notifiarr pour Discord…) sont nombreuses.

**Points forts** : **C++ = léger et rapide**, **GPL-2.0**, ultra-stable, compatible partout (CPU ARM, x86, RISC-V), **scheduler** natif.

**Points faibles** : UI web moins moderne que SABnzbd (qui a un design refait en 2023), **étoiles GitHub basses** (le projet est historiquement sur SourceForge, miroir Git plus tardif), **pas de gestion de queue multiple** aussi fine que SABnzbd.

## Installation

### Via Docker (recommandé)

```yaml
# docker-compose.yml
services:
  nzbget:
    image: lscr.io/linuxserver/nzbget:latest
    container_name: nzbget
    restart: unless-stopped
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Paris
    volumes:
      - ./config:/config
      - ./downloads:/downloads    # destination des NZB terminés
      - /mnt/media:/media         # bibliothèque partagée
    ports:
      - "6789:6789"
```

### Installation manuelle

Paquets `.deb`/`.rpm` disponibles sur le site officiel (et via `apt`/`dnf`). Sinon compilation depuis sources : `make -j$(nproc) && make install`. Démarrage : `nzbget -D` (daemon) ou `nzbget -s` (console), UI sur `http://localhost:6789` (admin/nzbget par défaut, à changer immédiatement).

## Configuration

1. **Premier lancement** : se connecter à `http://localhost:6789`, login par défaut `nzbget` / `nzbget` — **changer immédiatement**.
2. **Serveur Usenet** : `Settings → News-Servers` → ajouter le serveur de votre provider (Eweka, Newshosting, BlockNews, etc.) avec username, password, **connections** (50 par défaut, à ajuster selon quota provider), **encryption** (TLS obligatoire).
3. **Catégories & dossiers** : `Movies` → `/media/movies`, `TV` → `/media/tv`, etc.
4. **Post-processing scripts** : `Settings → Post-processing` → `Extensions` → activer `Cleanshots`, `Email`, `Logger`, et tout ce qui vous intéresse.
5. **Scheduler** : `Settings → Scheduler` → `Task1: Download rate=10MB/s, Time=08:00-22:00` ; `Task2: Full speed, Time=22:00-08:00`.
6. **Intégration \*arr** : dans Sonarr/Radarr, ajouter un Download Client de type "NZBGet", URL `http://nzbget:6789`, user/password, catégorie dédiée.
7. **Reverse proxy** : `nzbget.example.com` via Caddy + Authelia, **HTTPS obligatoire**.

## Alternatives

### Open source
- [[app-sabnzbd]] — concurrent direct, **UI plus moderne**, **Python** (légèrement plus lourd).
- [[app-nzb-dav]] — couche **WebDAV streaming** au-dessus de NZBGet.
- [[app-sonarr]] / [[app-radarr]] / [[app-lidarr]] — les **consommateurs** typiques.
- [[app-prowlarr]] — agrégateur d'indexers Usenet.
- [[app-nzbhydra2]] — méta-indexer qui unifie plusieurs indexers.

### Propriétaires
- **Newsbin Pro** — client Usenet Windows historique, payant.
- **GrabIt** — idem, Windows-only.
- **Real-Debrid / AllDebrid** — services de cache "debrid" qui remplacent parfois NZBGet côté lecture.

## Sécurité

- ⚠️ **Credentials Usenet** : à protéger,泄露 = quelqu'un consomme votre quota provider. Utiliser un user Usenet dédié.
- ⚠️ **Reverse proxy + auth obligatoire** : l'UI NZBGet permet de **supprimer des downloads, gérer les files**, exposition sensible.
- ⚠️ **TLS pour NNTP** : port **563** (NNTPS) — éviter le port 119 en clair.
- ⚠️ **Quota provider** : surveiller la consommation (par2, retêtes), un download raté en boucle peut épuiser le forfait mensuel.
- ⚠️ **Rétention provider** : un provider avec **4500+ jours** de rétention permet de retrouver d'anciens posts.
- ✅ **Pas de DB** : état dans `~/.nzbget`, sauvegarder `./config`.
- ✅ **Surface minimale** : binaire C++ compilé, pas de runtime à patcher.

## Ressources
- [Site officiel](https://nzbget.com)
- [Documentation](https://nzbget.com/documentation)
- [Wiki Sonarr/Radarr](https://wiki.servarr.com)
- [selfh.st — Downloads](https://selfh.st/apps/?tag=downloads)

## Pages Liées
- [[cat-downloads]] — Catégorie parente
- [[app-sabnzbd]] — Concurrent direct
- [[app-nzb-dav]] — Streaming WebDAV
- [[app-sonarr]] / [[app-radarr]] / [[app-lidarr]] — Consommateurs \*arr
- [[app-prowlarr]] — Agrégateur d'indexers
- [[recettes-docker-compose]] — Templates Docker
- [[securisation-home-lab]] — Bonnes pratiques