Skip to content

Unpackerr

Unpackerr monitors download clients for completed downloads containing compressed archives (rar, zip, etc.) and automatically extracts them. After extraction, it notifies Sonarr and Radarr so they can import the files into the media library.

Details

Property Value
Helm chart app-template v4.6.2 (bjw-s)
Image ghcr.io/unpackerr/unpackerr:v0.15.2
Port 5656 (health/metrics only)
HTTPRoute -- (internal only)
Namespace arr
ArgoCD app arr-unpackerr
Sync wave 1
Internal URL http://arr-unpackerr.arr.svc.cluster.local:5656

Storage

Volume Type Size Mount Path
data PVC (existing arr-data) -- /data

Resources

CPU Memory
Requests 50m 128Mi
Limits -- 256Mi

Key Configuration

  • Timezone injected from ConfigMap arr-env.
  • All configuration is via environment variables -- no config file needed.
  • Connects to Sonarr, Radarr, and qBittorrent via in-cluster service DNS.
  • API keys and passwords are injected from the unpackerr-secrets Secret (synced from Vault via ESO).
  • Prometheus metrics exposed on port 5656 when UN_WEBSERVER_METRICS is true.
  • Liveness, readiness, and startup probes are enabled.
  • ArgoCD sync policy uses ServerSideApply and ServerSideDiff with automated pruning and self-heal.

Post-Deploy Setup

  1. Gather the required credentials:

    Secret Key Where to Find It
    UN_SONARR_0_API_KEY Sonarr > Settings > General > API Key
    UN_RADARR_0_API_KEY Radarr > Settings > General > API Key
    UN_QBIT_0_PASSWORD Your qBittorrent admin password

  2. Store credentials in Vault:

    vault kv put homelab/apps/unpackerr \
  UN_SONARR_0_API_KEY=your_key \
  UN_RADARR_0_API_KEY=your_key \
  UN_QBIT_0_PASSWORD=your_password
# ESO syncs it to K8s automatically via unpackerr-external-secret.yml

  3. ESO syncs the secret from Vault automatically.

  4. Verify the pod is running and check logs for successful connections:

    kubectl logs -n arr -l app.kubernetes.io/instance=arr-unpackerr

    Look for messages confirming connections to Sonarr, Radarr, and qBittorrent.

Dependencies

Dependency Purpose
Sonarr Notified after TV episode archives are extracted
Radarr Notified after movie archives are extracted
qBittorrent Monitored for completed torrent downloads
unpackerr-secrets Secret with API keys and passwords (synced from Vault)

Upstream