Choose a Plundarr preset¶
Maraudarr generates every normal deployment under dist/<preset>/ with one commented docker-compose.yml, one editable .env, and the selected service configuration directories. Choose the smallest preset that owns the job, then add or remove optional services deliberately.
Compare the presets¶
| Preset | Primary purpose | Required core | Removable defaults |
|---|---|---|---|
plundarr |
Movies, television, subtitles, ebooks, requests, monitoring, and VPN-protected downloads | Privateerr, Gluetun, Prowlarr, Radarr, Sonarr, Bazarr, Seerr, Homepage, Duplicati, and monitoring services | qBittorrent, Calibre-Web Automated, Cleanuparr, Watchtower, Tracearr |
boudoirr |
Whisparr-focused automation through the same VPN lane | Privateerr, Gluetun, FlareSolverr, Prowlarr, Whisparr | qBittorrent, Cleanuparr, Watchtower |
jellyfin |
One focused Jellyfin media server | Jellyfin | None |
plex |
One focused Plex Media Server | Plex | None |
calibre-web-automated |
Ebook library and automatic ingest | Calibre-Web Automated | None |
duplex |
Plex metadata, artwork, notifications, and optional recovery | Kometa, ImageMaid | PATTRMM, Notifiarr |
watchtower |
Persistent or one-shot updates for eligible host containers | Watchtower | None |
portainer |
Docker host management through Portainer Community Edition | Portainer | None |
custom |
A deployment assembled service by service | None | None |
Preset core services cannot be removed. Defaults are preselected conveniences that you may remove interactively or with REMOVE_SERVICES. Maraudarr resolves required companions before writing the final project.
Generate and inspect a preset¶
Replace YOUR-PRESET with a preset ID from the table. Review dist/YOUR-PRESET/.env before running make up PRESET=YOUR-PRESET.
Add or remove services¶
ADD_SERVICES and REMOVE_SERVICES accept comma-separated service IDs:
make ship PRESET=duplex ADD_SERVICES=watchtower
make ship PRESET=plundarr REMOVE_SERVICES=qbittorrent,cleanuparr ADD_SERVICES=nzbget
make ship PRESET=plundarr REMOVE_SERVICES=calibre-web-automated
Keep your complete ADD_SERVICES and REMOVE_SERVICES selection when regenerating; preserving environment values does not preserve a previous service selection. Tracearr is the default Plundarr monitor; Tautulli and Overlay Reset are optional. See media monitoring and the Duplex guide.
The old OPTIONAL_SERVICES interface has been removed. Maraudarr fails fast when it appears so an old automation command cannot silently generate the wrong fleet.
Run presets side by side¶
Each preset has its own Compose project and dist/<preset>/ directory. Bridge-network defaults run from 172.20.0.0/16 through 172.28.0.0/16: Watchtower uses 172.26.0.0/16, Portainer uses 172.27.0.0/16, and Custom uses 172.28.0.0/16. Some presets offset host ports; always check the generated values before running projects together.
Change a subnet when it overlaps your local-area network, another Docker network, or a route reached through a virtual private network. Plex uses host networking and is the main exception to the bridge-network pattern.
Move from a deprecated standalone chart¶
Use the matching Plundarr preset as a migration target, not an in-place Compose replacement:
See Upgrade to v2 for the full state-preservation and rollback checklist.
- Back up the old environment and application state.
- Generate the matching preset with the services you intend to keep.
- Map old values into the generated
.envand verify every host path. - Move persistent state only while the related containers are stopped.
- Validate the generated Compose model, then cut over one project at a time.
The deprecated standalone Duplex, Boudoirr, Jellyfin, and Calibre-Web-Automated repositories can remain useful as historical references, but their generated Plundarr presets keep current deployment behavior, dependency updates, and documentation in one maintained catalog.
Generate the default Plundarr stack Read the configuration guide