HELBACKUP
HELBACKUP
Docker app from Kreuzbube88's Repository
Overview
HELBACKUP is a self-hosted backup orchestrator built specifically for Unraid. One container, full control — no cloud dependency, no subscription.
Backup Types:
✓ Flash Drive — Incremental rsync of /boot with SHA-256 verification
✓ Appdata — Optional container stop/start, Docker config export included
✓ Virtual Machines — Libvirt snapshot, vDisk rsync, XML config export
✓ Docker Images — Save images as .tar archives via Docker API
✓ System Config — Network, users, shares, plugins, disk assignments
Targets:
✓ Remote NAS / Server — SSH + Rsync with optional strict host-key pinning
✓ Local Filesystem — Direct path on the Unraid array
✓ NAS Power Management — Wake-on-LAN before backup, auto-shutdown after
Job Engine:
✓ Visual Job Builder — Drag-and-drop step ordering with dependency graph
✓ Retry Logic — Linear or exponential backoff per step
✓ Pre/Post Hook Scripts — Run custom scripts around backup jobs
✓ Catch-Up on Start — Runs missed schedules after container restart
✓ Checksum Verification — SHA-256 validation for all backup files
Retention:
✓ Simple Retention — Keep last N backups with configurable minimum
✓ GFS Rotation — Grandfather-Father-Son: Daily / Weekly / Monthly, saves up to 90% storage
Security & Encryption:
✓ AES-256 Encryption — Optional end-to-end GPG encryption with recovery key
✓ First-Run Setup — No default passwords, admin account created on first access
✓ API Tokens — Scoped tokens with optional expiry
✓ Webhooks — HMAC-signed event delivery
Recovery:
✓ Granular File Restore — Browse and restore individual files or directories
✓ Full Server Restore Wizard — Step-by-step guided recovery for all backup types
✓ Flash Drive Restore — Complete /boot restoration with confirmation guard
Monitoring & Notifications:
✓ 7 Notification Channels — Email, Gotify, ntfy, Pushover, Telegram, Discord, Slack
✓ Live Logs — Real-time backup progress via SSE stream
✓ Dashboard — System status, per-target storage, 30-day history chart
✓ Prometheus Metrics — Ready-made monitoring integration
✓ German & English UI — Full i18n support
First-Time Setup:
- Install the container
- Open the Web UI
- Create your admin account
- Save your Recovery Key (shown once!)
- Follow the onboarding wizard to create your first backup
Documentation: https://github.com/Kreuzbube88/helbackup
Runtime arguments
- Web UI
http://[IP]:[PORT:3000]- Network
br0- Shell
sh- Privileged
- false
Template configuration
Port for the HELBACKUP web interface
- Target
- 3000
- Default
- 3000
- Value
- 3000
SSH keys and application config
- Target
- /app/config
- Default
- /mnt/user/appdata/helbackup/config
- Value
- /mnt/user/appdata/helbackup/config
SQLite database
- Target
- /app/data
- Default
- /mnt/user/appdata/helbackup/data
- Value
- /mnt/user/appdata/helbackup/data
Application logs
- Target
- /app/logs
- Default
- /mnt/user/appdata/helbackup/logs
- Value
- /mnt/user/appdata/helbackup/logs
Docker socket for container management (stop/start during backups)
- Target
- /var/run/docker.sock
- Default
- /var/run/docker.sock
- Value
- /var/run/docker.sock
⚠️ Unraid USB flash drive (READ-WRITE for automated Flash restore). PROTECTED: Write operations only allowed during explicit restore sessions with multi-step confirmation!
- Target
- /unraid/boot
- Default
- /boot
- Value
- /boot
⚠️ Unraid user array (READ-WRITE for automated restore). PROTECTED: Write operations only allowed during explicit restore sessions with multi-step confirmation!
- Target
- /unraid/user
- Default
- /mnt/user
- Value
- /mnt/user
⚠️ Unraid cache drive (READ-WRITE for restore). Required if appdata or VM disks live on cache (/mnt/cache/appdata/, /mnt/cache/domains/).
- Target
- /unraid/cache
- Default
- /mnt/cache
- Value
- /mnt/cache
⚠️ VM configurations (READ-WRITE for restore). Required for VM backup and restore. Remove if you don't use virtual machines.
- Target
- /unraid/libvirt
- Default
- /etc/libvirt
- Value
- /etc/libvirt
Libvirt Unix socket. Required for VM live snapshot support during backup. Only available when libvirt is running on the host — remove if not using VMs.
- Target
- /var/run/libvirt/libvirt-sock
- Default
- /var/run/libvirt/libvirt-sock
- Value
- /var/run/libvirt/libvirt-sock
Libvirt connection URI for VM management. Do not change unless your libvirt setup uses a different URI.
- Default
- qemu:///system
- Value
- qemu:///system
Required: Random secret for authentication. Generate with: openssl rand -hex 32
Set to false for local HTTP access. Set to true when using HTTPS via reverse proxy.
- Default
- false
- Value
- false
Timezone for scheduled backups (e.g., Europe/Berlin, America/New_York)
- Default
- Europe/Berlin
- Value
- Europe/Berlin
Log verbosity: debug, info, warn, error
- Default
- info
- Value
- info
User ID for file permissions (Unraid default: 99)
- Default
- 99
- Value
- 99
Group ID for file permissions (Unraid default: 100)
- Default
- 100
- Value
- 100
Categories
Details
ghcr.io/kreuzbube88/helbackup:latestRun HELBACKUP on Unraid.
HELBACKUP is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.