HELBACKUP

HELBACKUP

Aplicación Docker from Kreuzbube88's Repository

Visión general

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

Argumentos en tiempo de ejecución

Interfaz web
http://[IP]:[PORT:3000]
Red
br0
Concha
sh
Privilegiado
false

Configuración de plantillas

Web UI PortPorttcp

Port for the HELBACKUP web interface

Objetivo
3000
Por defecto
3000
Valor
3000
ConfigPathrw

SSH keys and application config

Objetivo
/app/config
Por defecto
/mnt/user/appdata/helbackup/config
Valor
/mnt/user/appdata/helbackup/config
DataPathrw

SQLite database

Objetivo
/app/data
Por defecto
/mnt/user/appdata/helbackup/data
Valor
/mnt/user/appdata/helbackup/data
LogsPathrw

Application logs

Objetivo
/app/logs
Por defecto
/mnt/user/appdata/helbackup/logs
Valor
/mnt/user/appdata/helbackup/logs
Docker SocketPathrw

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

Objetivo
/var/run/docker.sock
Por defecto
/var/run/docker.sock
Valor
/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!

Objetivo
/unraid/boot
Por defecto
/boot
Valor
/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!

Objetivo
/unraid/user
Por defecto
/mnt/user
Valor
/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/).

Objetivo
/unraid/cache
Por defecto
/mnt/cache
Valor
/mnt/cache
Libvirt ConfigsPathro

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

Objetivo
/unraid/libvirt
Por defecto
/etc/libvirt
Valor
/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.

Objetivo
/var/run/libvirt/libvirt-sock
Por defecto
/var/run/libvirt/libvirt-sock
Valor
/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.

Por defecto
qemu:///system
Valor
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.

Por defecto
false
Valor
false
TZVariable

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

Por defecto
Europe/Berlin
Valor
Europe/Berlin
LOG_LEVELVariable

Log verbosity: debug, info, warn, error

Por defecto
info
Valor
info
PUIDVariable

User ID for file permissions (Unraid default: 99)

Por defecto
99
Valor
99
PGIDVariable

Group ID for file permissions (Unraid default: 100)

Por defecto
100
Valor
100

Categorías

Detalles

Repositorio
ghcr.io/kreuzbube88/helbackup:latest
Última actualización2026-06-01
Visto por primera vez2026-04-09

Ejecute HELBACKUP en Unraid.

HELBACKUP se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.