---
title: nzbget Stack
description: Usenet Downloader
published: true
date: 2026-04-29T14:22:02.207Z
tags: docker,swarm,nzbget,netgrimoire
editor: markdown
dateCreated: 2026-04-29T14:22:02.207Z
---

# nzbget

## Overview
The nzbget stack is a Docker Swarm configuration for running the nzbget Usenet downloader service in NetGrimoire.

## Architecture

| Service | Image | Port | Role |
|---------|-------|------|-----|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `nzbget.netgrimoire.com`
- **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:nbzget /DockerVol/nzbget/
```

### 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
This service requires no specific post-deploy steps.

---

## User Guide

### Accessing nzbget
| Service | URL | Purpose |
|---------|-----|---------|
- **nzbget**: http://nzbget.netgrimoire.com

### Primary Use Cases
To use this service, ensure Caddy is configured to proxy requests to the nzbget service.

### NetGrimoire Integrations
This service connects to Uptime Kuma for monitoring and other services via environment variables.

---

## Operations

### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services nzbget
```

### Backups
The `/DockerVol/nzbget/data` directory is critical. The configuration and logs are located in `/DockerVol/nzbget/config`.

### Restore
```bash
cd services/swarm/stack/nzbget
./deploy.sh
```

---

## Common Failures

| Symptom | Cause | Fix |
|---------|-------|-----|
- Service not reachable | Incorrect Caddy configuration | Check and correct Caddy labels |
- Config file missing | Missing or corrupted `nzbget-stack.yml` | Re-generate the file using `docker stack config --compose-file nzbget-stack.yml > resolved.yml` |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | faa24337 | Initial configuration and documentation |
| 2026-04-29 | 80c275b7 | Minor tweaks to environment variables and Caddy labels |
| 2026-04-29 | 6386d82f | Added network and host constraints |
| 2026-04-29 | 338c639c | Changed `PGID` and `PUID` values |
| 2026-04-29 | fd825f33 | Reorganized configuration for better readability |
| 2026-04-29 | 9898ccf4 | Minor changes to Caddy labels |
| 2026-04-29 | 207f2dd0 | Fixed incorrect Caddy domain exposure |
| 2026-04-29 | c39e61fc | Updated `deploy.sh` script for consistency |
| 2026-04-29 | 5a7a69fb | Corrected service labels |
| 2026-04-29 | 2cf74711 | Minor adjustments to logging and backup configurations |

---

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