Deploy Now

Stars

140

Forks

3

Watchers

2

Developer links

Joulenap

A dedicated backup server is the right way to keep copies on separate hardware, and a strangely expensive one to leave humming in the corner for a job that runs twenty minutes a night. Joulenap lets that machine sleep: at the scheduled hour it sends a Wake-on-LAN packet to your Proxmox Backup Server, waits until the API answers, runs the backup, applies retention, runs garbage collection and verification if you asked for them, then powers the box back down or suspends it for network cards that only wake from sleep. You describe your setup as routes: which hosts back up to which backup server, on what schedule, keeping how many copies, with guests as everything on a host or an explicit list. Fan several hosts into one server nightly, or copy one backup server to another across town for an off-site second copy with its own retention. A second route kind starts nothing at all: your Proxmox hosts keep their own schedules while Joulenap simply wakes the box, watches their tasks, and switches it off when they go quiet. Watch live task output, stop a run mid-flight if you must, and get results through Apprise, Telegram, ntfy, Discord or email per route. Status widgets feed Homepage, Homarr, Dashy and Glance, and a Prometheus endpoint lets Grafana alert you when a guest stops being backed up. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.

Joulenap
Joulenap
Joulenap
Joulenap
Joulenap

Benefits

  • Backups Without The Idle Wattage
  • The backup server is awake only for the minutes a route needs it: Wake-on-LAN with readiness wait and retries, then power off or suspend, with power leases so overlapping routes wake it once.
  • Routes Model Real Topologies
  • Wire any number of Proxmox hosts and backup servers together: fan several hosts into one PBS, or sync one PBS to another for an off-site copy with its own retention options.
  • Retention, GC And Verification Included
  • Each route carries its own keep-last, daily, weekly, monthly and yearly retention, with optional garbage collection and verification after the run, plus ad-hoc GC or verify on a single box whenever you want one.
  • It Watches, Not Just Schedules
  • External-schedule routes let Proxmox run its own jobs while Joulenap wakes the target, watches the tasks, and powers down when they finish; run history with per-step timelines and live task output shows exactly what happened.

Features

  • Guided Device Wizards
  • Settings wizards add a Proxmox host and discover its known backup servers, or add a backup server and configure wake-up and power-off; scoped API tokens per device.
  • Live Logs And Run History
  • A live log viewer, per-run step timelines and streaming PVE and PBS task output, with manual runs per route and mid-flight stopping.
  • Five Notification Channels
  • Apprise, Telegram, ntfy, Discord and email alerts on success, failure or both, configured per route, with a per-channel test report.
  • Dashboard And Metrics Integrations
  • Backup status widgets for Homepage, Homarr, Dashy and Glance, plus a Prometheus metrics endpoint for Grafana alerting; datastore usage stays visible while a server sleeps.
  • Hardened Single Container
  • One Docker image with host networking for LAN broadcast, a single data directory, per-device PBS TLS pinning, SSH host-key verification and login rate limiting.
  • Built-In Config Editor
  • Every setting lives in one commented config.yaml created on first run; an advanced tab edits it in the browser with a global pause switch.

Apps Similar to Joulenap