---
title: nzbget Stack
description: Usenet Downloader for NetGrimoire
published: true
date: 2026-05-05T12:50:48.006Z
tags: docker,swarm,nzbget,netgrimoire
editor: markdown
dateCreated: 2026-05-05T12:50:48.006Z
---

# nzbget

## Overview
The nzbget Stack is a Docker Swarm service that provides Usenet downloading capabilities for NetGrimoire. It consists of the LinuxServer/nzbget image, which is configured to download and store new releases from various sources.

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

---

## Build & Configuration

### Prerequisites
This service requires Docker Swarm 2.0 or higher to function properly.

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

### Environment Variables
```bash
TZ=America/Chicago
PGID=1964
PUID=1964
GREMLIN_VERSION=2026-04-1
GREMLIN_PORT=6789
HOME_PAGE_GROUP=Nucking Apps
HOME_PAGE_NAME=Nzbget
HOME_PAGE_ICON=nzbget.png
HOME_PAGEHref=http://nzbget.netgrimoire.com
HOME_PAGE_DESCRIPTION=Usenet Downloader
DIUN_ENABLE=true
MONITOR_NAME=Nzbget
MONITOR_URL=https://nzbget.netgrimoire.com
CADDY=nbzget.netgrimoire.com
CADDY_IMPORT_AUTHENTIK=true
CADDY_REVERSE_PROXY=nzbget:6789
```

### 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
After the initial deployment, run `./deploy.sh` to perform any necessary setup.

---

## User Guide

### Accessing nzbget
| Service | URL | Purpose |
|---------|-----|---------|
- **Caddy Domain:** nzbget.netgrimoire.com (Reverse Proxy)
- **Internal Only:** http://nzbget.netgrimoire.com

### Primary Use Cases
To use this service in NetGrimoire, follow these steps:
1. Access the nzbget dashboard at <homepage group> > <homepage name>.
2. Configure your Usenet account and download settings as desired.

### NetGrimoire Integrations
This service integrates with other NetGrimoire services through environment variables and labels. Specifically, it connects to the monitoring system via `kuma.*` labels and exposes a reverse proxy endpoint at `<CADDY DOMAIN>`.

---

## Operations

### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services nzbget
<docker service logs commands>
```

### Backups
Critical backups are required for this service. Store your backup files in `/DockerVol/...` and ensure that the `config` volume is properly backed up.

### Restore
To restore from a backup, run `./deploy.sh` after restoring the `config` volume to the correct location.

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Service not starting | Docker Swarm issue | Check swarm node status and restart if necessary |
| Download failing | Configuration issue | Verify environment variables are set correctly and try redeploying |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-05-04 | 1846ab14 | Initial documentation and setup |
| 2026-05-04 | f60567db | Updated environment variables to include GREMLIN_PORT and other necessary settings |
| 2026-05-01 | c3b0c0f5 | Added kuma monitors for this service |
| 2026-04-29 | a91a2ded | Initial configuration of nzbget Stack |

---

## Notes
- Generated by Gremlin on 2026-05-05T12:50:48.006Z
- Source: swarm/nzbget.yaml
- Review User Guide and Changelog sections