---
title: nzbget Stack
description: Usenet Downloader
published: true
date: 2026-04-29T13:49:16.204Z
tags: docker,swarm,nzbget,netgrimoire
editor: markdown
dateCreated: 2026-04-29T13:49:16.204Z
---

# nzbget

## Overview
The nzbget Stack is a Docker Swarm configuration for the nzbget Usenet Downloader service, providing a reliable and efficient way to download and manage Usenet content in NetGrimoire.

---

## Architecture
| Service | Image | Port | Role |
|---------|-------|------|-----|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** nzbget.netgrimoire.com, http://nzbget:6789 (Internal only)
- **Homepage group:** Nucking Apps

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/nzbget/config
chown -R nzbget:nzbget /DockerVol/nzbget/config
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
TZ=America/Chicago
PGID=1964
PUID=1964
```

### Deploy
```bash
cd services/swarm/stack/nzbget
set -a && source .env && set +a
docker stack config --compose-file nzbget-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml nzbget
rm resolved.yml
docker stack services nzbget
```

### First Run
Run `./deploy.sh` to complete the initial deployment.

---

## User Guide

### Accessing nzbget
| Service | URL | Purpose |
|---------|-----|---------|
| caddy    | http://nzbget.netgrimoire.com | Reverse proxy for nzbget |

### Primary Use Cases
To use this service, follow these steps:
1. Start the nzbget service.
2. Configure and add new Usenet groups as needed.

### NetGrimoire Integrations
This service integrates with the following services in NetGrimoire:
- Homepage: Displays nzbget's status and information.
- Monitoring: Kuma monitors provide real-time monitoring for this service.

---

## Operations

### Monitoring
```bash
docker stack services nzbget
docker service logs nzbget -f --tail=100
```

### Backups
Critical data is stored in the `/DockerVol/nzbget/data` volume. Regular backups are essential to ensure the availability of this data.

### Restore
To restore from a backup, run `./deploy.sh`.

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Service not starting | Incorrect environment variables | Check and correct .env file. |
| Configuration errors | Inconsistent nzbget configuration | Review nzbget configuration files for inconsistencies. |
| Data loss | Incorrect backups | Regularly check and restore backup data. |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | 207f2dd0 | Initial configuration |
| 2026-04-29 | c39e61fc | Update .env file |
| 2026-04-29 | 5a7a69fb | Add environment variables for secure configuration |
| 2026-04-29 | 2cf74711 | Correct deployment issues |
| 2026-04-29 | 7b1701b4 | Fix configuration errors |
| 2026-04-29 | 1f72151b | Update nzbget version to latest available |
| 2026-03-30 | e8c09e02 | Initial changes for swarm config |
| 2026-03-22 | 85a51221 | Add volume setup for configuration directory |
| 2026-02-20 | 23912a90 | Initial Docker Swarm setup |

---

## Notes
- Generated by Gremlin on 2026-04-29T13:49:16.204Z
- Source: swarm/nzbget.yaml
- Review User Guide and Changelog sections