HELBACKUP

HELBACKUP

Application Docker from Kreuzbube88's Repository

Vue d'ensemble

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:

  1. Install the container
  2. Open the Web UI
  3. Create your admin account
  4. Save your Recovery Key (shown once!)
  5. Follow the onboarding wizard to create your first backup

Documentation: https://github.com/Kreuzbube88/helbackup

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:3000]
Réseau
br0
Coquille
sh
Privilégié
false

Configuration du modèle

Web UI PortPorttcp

Port for the HELBACKUP web interface

Cible
3000
Défaut
3000
Valeur
3000
ConfigPathrw

SSH keys and application config

Cible
/app/config
Défaut
/mnt/user/appdata/helbackup/config
Valeur
/mnt/user/appdata/helbackup/config
DataPathrw

SQLite database

Cible
/app/data
Défaut
/mnt/user/appdata/helbackup/data
Valeur
/mnt/user/appdata/helbackup/data
LogsPathrw

Application logs

Cible
/app/logs
Défaut
/mnt/user/appdata/helbackup/logs
Valeur
/mnt/user/appdata/helbackup/logs
Docker SocketPathrw

Docker socket for container management (stop/start during backups)

Cible
/var/run/docker.sock
Défaut
/var/run/docker.sock
Valeur
/var/run/docker.sock
Unraid Flash DrivePathrw

⚠️ Unraid USB flash drive (READ-WRITE for automated Flash restore). PROTECTED: Write operations only allowed during explicit restore sessions with multi-step confirmation!

Cible
/unraid/boot
Défaut
/boot
Valeur
/boot
Host System (Restore)Pathrw

⚠️ Unraid user array (READ-WRITE for automated restore). PROTECTED: Write operations only allowed during explicit restore sessions with multi-step confirmation!

Cible
/unraid/user
Défaut
/mnt/user
Valeur
/mnt/user
Cache DrivePathrw

⚠️ Unraid cache drive (READ-WRITE for restore). Required if appdata or VM disks live on cache (/mnt/cache/appdata/, /mnt/cache/domains/).

Cible
/unraid/cache
Défaut
/mnt/cache
Valeur
/mnt/cache
Libvirt ConfigsPathro

⚠️ VM configurations (READ-WRITE for restore). Required for VM backup and restore. Remove if you don't use virtual machines.

Cible
/unraid/libvirt
Défaut
/etc/libvirt
Valeur
/etc/libvirt
Libvirt SocketPathrw

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.

Cible
/var/run/libvirt/libvirt-sock
Défaut
/var/run/libvirt/libvirt-sock
Valeur
/var/run/libvirt/libvirt-sock
LIBVIRT_DEFAULT_URIVariable

Libvirt connection URI for VM management. Do not change unless your libvirt setup uses a different URI.

Défaut
qemu:///system
Valeur
qemu:///system
JWT_SECRETVariable

Required: Random secret for authentication. Generate with: openssl rand -hex 32

SECURE_COOKIESVariable

Set to false for local HTTP access. Set to true when using HTTPS via reverse proxy.

Défaut
false
Valeur
false
TZVariable

Timezone for scheduled backups (e.g., Europe/Berlin, America/New_York)

Défaut
Europe/Berlin
Valeur
Europe/Berlin
LOG_LEVELVariable

Log verbosity: debug, info, warn, error

Défaut
info
Valeur
info
PUIDVariable

User ID for file permissions (Unraid default: 99)

Défaut
99
Valeur
99
PGIDVariable

Group ID for file permissions (Unraid default: 100)

Défaut
100
Valeur
100

Catégories

Détails

Référentiel
ghcr.io/kreuzbube88/helbackup:latest
Dernière mise à jour2026-05-31
Première vue2026-04-09

Exécutez HELBACKUP sur Unraid.

HELBACKUP est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.