duplicacy-container

Container image and Helm chart repository for running a production-friendly Duplicacy stack on Kubernetes.

This repo now owns two related deliverables:

• the drumsergio/duplicacy-container runtime image for Kubernetes-native Duplicacy jobs
• the duplicacy Helm chart that packages the stack around it
• duplicacy-exporter for Prometheus metrics
• an optional Duplicacy Web UI pod, disabled by default and kept generic so you can choose the image and startup model you trust

Why This Repo Exists

The Duplicacy Kubernetes story spans multiple sibling projects:

• duplicacy-cli-cron handles the backup execution model
• duplicacy-exporter turns backup activity into Prometheus metrics
• the chart glues them together into a reusable stack with PVCs, secrets, ingress, and monitoring

That stack is bigger than an exporter-only concern, so it lives better in its own repo.

Included Components

• Dockerfile + entrypoint.sh - runtime image for one-shot or cron-style Duplicacy execution
• charts/duplicacy - Duplicacy stack chart with backup job, exporter, and optional Web UI

Highlights

• A dedicated Duplicacy runtime image decoupled from the scripts-only repo
• One-shot Kubernetes-native backup scheduling instead of running a daemonized cron container
• Shared log PVC support for duplicacy-exporter log tail mode
• Optional webhook mode for Duplicacy Web UI
• Optional generic Web UI pod support on port 3875
• values.schema.json, chart README, and Helm CI/release workflows
• Designed for real operators: existing secrets, existing PVCs, ServiceMonitor support, and escape hatches via extraEnv/extraVolumes

Quick Start

helm upgrade --install duplicacy ./charts/duplicacy -f my-values.yaml

See charts/duplicacy/README.md for chart-specific values and examples.

Web UI Support

The Web UI component is intentionally:

• disabled by default
• generic rather than hardcoded to one wrapper image
• configured through web.image.*, web.command, web.args, and optional ingress/PVC settings

This keeps the chart useful without baking in a deployment choice that may not fit every operator or licensing situation.

Runtime Image

The bundled image is intentionally minimal:

• it ships Duplicacy CLI plus shoutrrr
• it keeps the familiar periodic directory layout
• it expects operators to mount their own /config and /etc/periodic/* content

That lets duplicacy-cli-cron stay focused on reusable scripts and backup recipes while this repo owns the runtime/container distribution.

Related Projects

• duplicacy-container - Runtime image and Kubernetes stack chart for Duplicacy
• duplicacy-cli-cron - Scripts, wrappers, and backup recipes for Duplicacy CLI
• duplicacy-exporter - Prometheus exporter for Duplicacy backup metrics
• Duplicacy - lock-free deduplication backup tool

License

duplicacy-container is licensed under GPL-3.0-or-later.