HELBACKUP
Docker-Anwendung from Kreuzbube88's Repository
Übersicht
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
Laufzeit-Argumente
- Web-UI
http://[IP]:[PORT:3000]- Netzwerk
br0- Shell
sh- Privilegiert
- false
Konfiguration der Vorlage
Port for the HELBACKUP web interface
- Ziel
- 3000
- Standard
- 3000
- Wert
- 3000
SSH keys and application config
- Ziel
- /app/config
- Standard
- /mnt/user/appdata/helbackup/config
- Wert
- /mnt/user/appdata/helbackup/config
SQLite database
- Ziel
- /app/data
- Standard
- /mnt/user/appdata/helbackup/data
- Wert
- /mnt/user/appdata/helbackup/data
Application logs
- Ziel
- /app/logs
- Standard
- /mnt/user/appdata/helbackup/logs
- Wert
- /mnt/user/appdata/helbackup/logs
Docker socket for container management (stop/start during backups)
- Ziel
- /var/run/docker.sock
- Standard
- /var/run/docker.sock
- Wert
- /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!
- Ziel
- /unraid/boot
- Standard
- /boot
- Wert
- /boot
⚠️ Unraid user array (READ-WRITE for automated restore). PROTECTED: Write operations only allowed during explicit restore sessions with multi-step confirmation!
- Ziel
- /unraid/user
- Standard
- /mnt/user
- Wert
- /mnt/user
⚠️ Unraid cache drive (READ-WRITE for restore). Required if appdata or VM disks live on cache (/mnt/cache/appdata/, /mnt/cache/domains/).
- Ziel
- /unraid/cache
- Standard
- /mnt/cache
- Wert
- /mnt/cache
⚠️ VM configurations (READ-WRITE for restore). Required for VM backup and restore. Remove if you don't use virtual machines.
- Ziel
- /unraid/libvirt
- Standard
- /etc/libvirt
- Wert
- /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.
- Ziel
- /var/run/libvirt/libvirt-sock
- Standard
- /var/run/libvirt/libvirt-sock
- Wert
- /var/run/libvirt/libvirt-sock
Libvirt connection URI for VM management. Do not change unless your libvirt setup uses a different URI.
- Standard
- qemu:///system
- Wert
- 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.
- Standard
- false
- Wert
- false
Timezone for scheduled backups (e.g., Europe/Berlin, America/New_York)
- Standard
- Europe/Berlin
- Wert
- Europe/Berlin
Log verbosity: debug, info, warn, error
- Standard
- info
- Wert
- info
User ID for file permissions (Unraid default: 99)
- Standard
- 99
- Wert
- 99
Group ID for file permissions (Unraid default: 100)
- Standard
- 100
- Wert
- 100
Kategorien
Einzelheiten
ghcr.io/kreuzbube88/helbackup:latestFühren Sie HELBACKUP auf Unraid aus.
HELBACKUP ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.