pbs-plus
A Proxmox Backup Server (PBS) "extension" server that aims to add features and make PBS a true alternative to Veeam.
Automatically checked · GitHub checked 2026-11-14

Overview
Proxmox Backup Server (PBS) Plus
Advanced backup features for Proxmox Backup Server: file-level backup/restore, native PostgreSQL and MySQL/MariaDB backups, read/write FUSE mounting of archives, data verification, MTF/LTO tape migration, and a Kubernetes operator.
Quick Links
| Topic | Document |
|---|---|
| How it works, architecture, ports | Architecture |
| Server, agent, container, operator install | Installation |
| Backup/restore jobs, S3 and database targets, hook scripts, snapshot mounts, verification, tape migration | Usage |
| NFS/SMB serving endpoints for mounted snapshots | Outposts |
| Read/write FUSE mount for PBS archives | pxar-mount |
| K8s operator for annotated PVCs | Kubernetes Operator |
| CI workflows and E2E testing | Development |
Installation
Server: install the .deb on your PBS machine, then:
echo "PBS_PLUS_HOSTNAME=$(hostname -f)" >> /etc/proxmox-backup/pbs-plus/pbs-plus.env
systemctl restart pbs-plus
Agent (Linux): install the package, set env vars in the agent env file, restart:
sudo tee /etc/pbs-plus-agent/agent.env >/dev/null <<EOF
PBS_PLUS_INIT_SERVER_URL="https://<pbs>:8008"
PBS_PLUS_INIT_BOOTSTRAP_TOKEN="<token>"
PBS_PLUS_HOSTNAME="$(hostname -f)"
EOF
sudo chown -R pbsplus:pbsplus /etc/pbs-plus-agent
sudo chmod 0640 /etc/pbs-plus-agent/agent.env
systemctl restart pbs-plus-agent
Agent (Docker):
docker run -d --name pbs-plus-agent \
--cap-add=DAC_READ_SEARCH \
-e PBS_PLUS_INIT_SERVER_URL="https://<pbs>:8008" \
-e PBS_PLUS_INIT_BOOTSTRAP_TOKEN="<token>" \
-e PBS_PLUS_HOSTNAME="$(hostname -f)" \
-v /srv/pbs-plus-agent/lib:/var/lib/pbs-plus-agent \
-v /srv/pbs-plus-agent/log:/var/log/pbs-plus-agent \
-v /srv/pbs-plus-agent/etc:/etc/pbs-plus-agent \
ghcr.io/pbs-plus/pbs-plus-agent:latest
See Installation for Windows agent, Kubernetes operator, and details.
Contributing
PRs welcome. See Development for CI and test details.