Plundarr v1.1.0: NZBGet Joins the Fleet 🏴‍☠️

Plundarr v1.1.0: NZBGet Joins the Fleet 🏴‍☠️

Plundarr 1.1.0 is a backward-compatible minor release that adds NZBGet as an opt-in Maraudarr downloader and launches source-generated developer documentation for Maraudarr. Existing default deployments remain unchanged until NZBGet is selected.

NZBGet Boards the Usenet Deck ⚡

• Adds lscr.io/linuxserver/nzbget as a fully selectable Maraudarr service with shared Plundarr anchors, Gluetun networking, Synology-friendly mounts, and a direct executable healthcheck.
• Generates a strong first-run NZBGET_PASS while preserving existing credentials during regeneration.
• Publishes the fixed internal port 6789 through Gluetun only when NZBGet is selected.
• Adds Homepage integration plus generated setup guidance for paths, categories, Radarr, Sonarr, and Web UI access.
• Supports NZBGet by itself or alongside SABnzbd as a separate queue.
• Extends downloader validation and the generation matrix with NZBGet-specific voyages.

Maraudarr Opens the Developer Chart Room 📚

• Adds a Material for MkDocs developer site with architecture, service-authoring, testing, and documentation guides.
• Generates the public Python API reference directly from docker/src/maraudarr with mkdocstrings.
• Adds make docs and make docs-serve, pinned documentation dependencies, strict validation, and GitHub Pages publication.
• Clarifies the generation flow from service selection through atomic file publication and state-preserving configuration seeding.
• Gives the developer site accessible light and dark palettes, responsive navigation, and project-specific visual landmarks.
• Keeps Plundarrpedia focused on task-oriented deployment guidance instead of duplicating implementation documentation.

Maintenance Below Deck 🧰

• Updates Python to 3.14.7, setuptools to 84, and the Docker CLI image to 29.7.2.
• Refreshes the pinned build-provenance Action.
• Separates Renovate matchers so wrapped environment defaults no longer create malformed duplicate dependencies.
• Adds repository-wide Markdownlint policy and developer-documentation validation.

Upgrading from v1.0.2 ⚓

1. Back up runtime configuration with make backup-config.
2. Refresh Maraudarr with make update-maraudarr.
3. Regenerate with make configure, or select NZBGet with make ship PRESET=plundarr OPTIONAL_SERVICES=nzbget.
4. Inspect the generated deployment with make config, then recreate the fleet with make up.

No environment-variable rename or application-data migration is required for an existing deployment. NZBGet is opt-in, so the checked-in default preset and existing generated stacks do not gain the service automatically.

Published Fleet 📦

The release workflow published Maraudarr tags 1.1.0, 1.1, 1, latest, and sha-e4c7acb to GHCR and mirrored the same manifest to Docker Hub. The manifest supports linux/amd64, linux/arm64, and linux/arm/v7, with SBOM and provenance attached.

Both registries expose manifest digest sha256:86a32786a5ba2683c414334803dda462e80d7c78714e97c4635cd01e2f6f6200.

Validation 🧪

The merged change sets passed the Maraudarr unit suite and representative generation matrix, multi-architecture image builds for linux/amd64, linux/arm64, and linux/arm/v7, strict MkDocs builds, pre-commit, Markdownlint, Ruff documentation checks, and Compose validation. The release target is the passing main commit e4c7acb.

Merged Voyage 📜

• #38: Add NZBGet and Maraudarr developer docs.
• #39: Refresh build-provenance Action pin.
• #40: Update Python to 3.14.7.
• #41: Update setuptools to 84.
• #42: Update the Docker CLI image to 29.7.2.
• #43: Pin the developer chart-room background to the viewport.
• #44: Correct Maraudarr Renovate image matching.
• #45: Clarify generation flow and developer navigation.

Full Changelog: v1.0.2...v1.1.0