BackupMGR Demo Documentation
Self-hosted backup control plane: a Manager you install once, and lightweight agents you drop onto each host you want to protect. Snapshots are deduplicated, encrypted, and pruned automatically.
The Manager queues jobs and stores backups; it never connects to your hosts. Agents poll the Manager over outbound HTTPS and do the work — either backing up their own host (agent connector) or acting as a gateway that pulls a remote host over SSH/FTP (agentless connectors). Snapshots are written with a bundled kopia into per-host repositories.
Supported OS: Linux x86_64 (Ubuntu 22.04+, Debian 12+).
On a fresh Ubuntu 22.04+/Debian 12 server, clone the repo and run the installer. It provisions PHP, MariaDB, nginx, the app, a queue worker + scheduler, and (with SSL=1) a Let's Encrypt certificate.
git clone https://github.com/scriptgain/backup-mgr.git
cd backup-mgr
sudo DOMAIN=backup.example.com SSL=1 EMAIL=you@example.com \
LICENSE_KEY=XXXX-XXXX-XXXX-XXXX ./deploy/install-master.shPoint DNS at the server first so the certificate can be issued. After install, create your admin user and log in. A default Local Director and a Local Backups repository are provisioned automatically.
In the Manager, add a Host (type Agent) to get a one-time enrollment token. Then, on the host you want to back up:
curl -fsSL https://backup-demo.scriptgain.com/downloads/agent-install.sh | sudo bash -s -- \
https://backup-demo.scriptgain.com The installer downloads a static agent + kopia to /opt/backup, enrolls the host, and installs a backup-agent systemd service that polls for jobs. Check it with systemctl status backup-agent.
Agent
Backs up its own host's files or databases (mysqldump / pg_dump).
SSH / Rsync
A gateway pulls a remote host's files over SSH (key or password). Back up one path, or several paths in one snapshot.
SFTP
Pulled over SSH, same as rsync.
FTP
A gateway mirrors a remote FTP account — handy for shared hosting with FTP-only access.
Multi-FTP
One host, many FTP logins — ideal for a WHM/reseller server where you only have FTP to each cPanel account. Each login is pulled into its own folder in a single snapshot within the repository.
For agentless hosts, set the host's connection type, address, and credentials; the gateway agent in that Director does the pulling. Gateway prerequisites: rsync, wget (FTP), and DB client tools where relevant.
A repository is where snapshots land. Supported backends:
- Filesystem — a path on the Manager/gateway (e.g. the default
/var/backups/backupmgr). Best for centralized, on-box storage. - S3 / S3-compatible — Amazon S3, Backblaze B2, Wasabi, MinIO, or your own StorageMGR instance. Best for offsite copies.
Repositories are encrypted by kopia with a per-repo password, and snapshots are deduplicated across every host that shares the repository.
Assign a job a schedule (prebuilt templates like Daily 2 AM, or a custom cron) and a retention policy (keep N daily/weekly/monthly). kopia prunes and runs maintenance automatically within the window you set under Settings → Maintenance.
The Manager checks for new signed releases as part of its license check. When one is available you'll see a badge on Settings → Updates and a banner across the app. Click Update Now, or enable Automatic Updates to apply new releases automatically, soon after they're published. Each update is checksum-verified and the previous build is archived before it is applied.
Enter your license key under Settings → License. The install validates it against the vendor (signature-verified) and re-checks periodically; if the check can't be reached it runs on a grace window and never locks you out of a restore.
No sections match “”.