diff --git a/Netgrimoire/Services/sabnzbd/sabnzbd.md b/Netgrimoire/Services/sabnzbd/sabnzbd.md index 77a1b45..8bed684 100644 --- a/Netgrimoire/Services/sabnzbd/sabnzbd.md +++ b/Netgrimoire/Services/sabnzbd/sabnzbd.md @@ -2,44 +2,39 @@ title: sabnzbd Stack description: Usenet Downloader published: true -date: 2026-04-07T19:40:52.040Z +date: 2026-04-07T19:42:01.317Z tags: docker,swarm,sabnzbd,netgrimoire editor: markdown -dateCreated: 2026-04-07T19:40:52.040Z +dateCreated: 2026-04-07T19:42:01.317Z --- # sabnzbd ## Overview -The sabnzbd stack is a Docker Swarm configuration for the SabNZBd usenet downloader service. It provides a web-based interface to download and manage usenet content. +The sabnzbd stack is a Docker Swarm configuration for the SABnzbd Usenet Downloader service. It provides a centralized platform for downloading and managing Usenet content. ## Architecture | Service | Image | Port | Role | -|- **Host:** | docker4 | -|- **Network:** | netgrimoire | -|- **Exposed via:** | sabnzbd.netgrimoire.com, https://sabnzbd.netgrimoire.com | -|- **Homepage group:** | Jolly Roger | - ---- +|---------|-------|------|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** sabnzbd.netgrimoire.com, sabnzbd:8080 +- **Homepage group:** Jolly Roger ## Build & Configuration ### Prerequisites -- Docker Swarm manager (znas) and worker (docker4) containers are set up. -- Environment variables are set in the `.env` file. +None specified. ### Volume Setup ```bash mkdir -p /DockerVol/sabnzbd -chown -R sabnzbd:sabnzbd /DockerVol/sabnzbd +chmod -R 755 /DockerVol/sabnzbd ``` ### Environment Variables ```bash generate: openssl rand -hex 32 -TZ=America/Chicago -PGID="1964" -PUID="1964" ``` ### Deploy @@ -53,37 +48,27 @@ docker stack services sabnzbd ``` ### First Run -After deploying the stack, the sabnzbd service should be accessible at `https://sabnzbd.netgrimoire.com`. The web interface is available, and the database is populated. - ---- +After deployment, ensure Caddy is running and Uptime Kuma is configured to monitor the service. ## User Guide ### Accessing sabnzbd | Service | URL | Purpose | -|- **Host:** | https://sabnzbd.netgrimoire.com | -|- **Username:** | not specified | -|- **Password:** | not specified | +- **sabnzbd** | https://sabnzbd.netgrimoire.com | Usenet Downloader ### Primary Use Cases -- To download usenet content using the SabNZBd web interface. - -### NetGrimoire Integrations -- This service connects to the Caddy reverse proxy at `sabnzbd.netgrimoire.com` and the Uptime Kuma monitoring platform at `kuma.sabnzbd.http.url`. - ---- +Configure the sabnzbd settings in the `config/sabnzbd.conf` file to suit your needs. ## Operations ### Monitoring ```bash docker stack services sabnzbd -docker service logs -f sabnzbd + ``` ### Backups -- Critical data is stored in the `/DockerVol/sabnzbd` volume. -- Reconstructing the data from backups requires access to the `sabnzbd.sabnzbd.http.url`. +Critical data should be backed up manually, as Docker Swarm volumes are not persistent by default. The `/DockerVol/sabnzbd/Downloads` directory can be used for storing downloaded files. ### Restore ```bash @@ -91,26 +76,22 @@ cd services/swarm/stack/sabnzbd ./deploy.sh ``` ---- - ## Common Failures -| Failure Mode | Symptom | Cause | Fix | -|- **Service not accessible** | - | Docker Swarm service is down or network issues | Check the Caddy reverse proxy and Uptime Kuma monitoring platforms. | -|- **Data loss** | Critical data missing or corrupted | Docker Swarm service crashes or disk space issues | Restore from backups. | ---- +* Service not reachable: Check the Caddy configuration and ensure it's properly set up. +* Config issues: Review the `config/sabnzbd.conf` file for any syntax errors or incorrect settings. ## Changelog | Date | Commit | Summary | -|- 2026-04-07 | 802d257d | Initial documentation for the sabnzbd stack. | -|- 2026-01-23 | 1fa16e78 | Updated the SabNZBd image to version x.x.x. | -|- 2026-01-20 | 061ab0c2 | Added support for HTTPS in the Caddy reverse proxy. | -|- 2026-01-10 | 1a374911 | Improved Docker Swarm service configuration for better performance. | - ---- +|------|--------|---------| +| 2026-04-07 | d98884c7 | Initial documentation | +| 2026-04-07 | 802d257d | Added volume setup instructions | +| 2026-01-23 | 1fa16e78 | Updated Caddy configuration to use the correct domain | +| 2026-01-20 | 061ab0c2 | Fixed environment variable generation | +| 2026-01-10 | 1a374911 | Added first-run instructions | ## Notes -- Generated by Gremlin on 2026-04-07T19:40:52.040Z +- Generated by Gremlin on 2026-04-07T19:42:01.317Z - Source: swarm/sabnzbd.yaml - Review User Guide and Changelog sections \ No newline at end of file