Backup Orchestration for Home Labs.
Centralised, unified backup workflows across Proxmox, NAS servers, ZFS pools, containers, databases, and cloud storage — from one visual interface.
Every system in your home lab has its own backup schedule, its own script, its own log. Proxmox backups buried in datacenter config. ZFS snapshots managed per-pool. rsync cron jobs scattered across a dozen machines. Restic and Borg jobs you haven't verified in months. No unified dashboard, no central alert, no single place to know whether last night's backups actually worked.
Orchelium fixes this.
Orchelium was built specifically for the challenges of home-lab backup workflows:
- Proxmox — snapshot, backup, and verify VMs and LXC containers across multiple hosts
- ZFS — create snapshots, send to remote pools, prune, and verify integrity in one chain
- Restic & Borg — run, check, prune, and verify; structured output lets downstream nodes react automatically
- rsync & rclone — sync between local paths, remote hosts, or cloud storage (S3, Backblaze B2, and more)
- Databases — native plugins for MySQL, PostgreSQL, and SQLite
- Pre/post scripts — quiesce VMs, mount pools, dump databases, then clean up — all in the workflow chain
- Backup verification — chain a verify step after every backup; failures block downstream steps and trigger alerts
- Failure alerts — instant notifications via Discord, Telegram, or email
Design multi-step backup pipelines using a drag-and-drop node editor:
- Sequential or parallel execution
- Conditional branching
- Real-time step-by-step monitoring
- Live log streaming from every node
19+ official plugins covering backup, databases, file sync, storage, containers, and system tools. Install in one click from the Plugin Manager. Browse the catalog at orchelium.com/plugins.
Lightweight agents run on any Linux machine — Proxmox hosts, NAS servers, VMs, Docker hosts:
- Encrypted WebSocket or MQTT transport
- Real-time status and heartbeat
- Live log streaming
- Auto-reconnect
Trigger workflows from:
- Cron-style schedules
- Threshold rules (CPU, disk, memory)
- Webhooks (Home Assistant, GitHub Actions, Proxmox hooks, any HTTP source)
- Agent online/offline events
docker run -d \
--name orchelium \
-p 3000:3000 \
-v orchelium-data:/app/data \
ghcr.io/dpembo/orchelium:latestOpen http://localhost:3000 in your browser.
Generate a registration command from the UI, then run it on any Linux machine. Agents register automatically, authenticate, and begin streaming status and logs immediately.
Official plugins are maintained in a separate repository:
Plugins use a simple plugin.yaml + shell script format and are easy to write. See the Plugin Developer Guide to contribute.
Full documentation: docs/
| Guide | Description |
|---|---|
| Installation | Deploy the hub and agents |
| Orchestrations | Build and run workflows |
| Plugin Manager | Install and manage plugins |
| REST API | Automate via HTTP |
| Webhooks | Trigger jobs from external systems |
| Backup Schedules | Scheduling reference |
Extended docs also available at deepwiki.com/dpembo/orchelium.
| Repo | Description |
|---|---|
| dpembo/orchelium-plugins | Official plugin registry (19+ plugins) |
| dpembo/orchelium-website | orchelium.com marketing site |
Contributions are welcome — bug reports, feature ideas, pull requests, and new plugins. See CONTRIBUTING.md (coming soon) or open an issue to start a discussion.
- GitHub Issues — bugs and feature requests
- GitHub Discussions — general questions and ideas
Apache License 2.0 — see LICENSE for details.