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

pbs-plus

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

TopicDocument
How it works, architecture, portsArchitecture
Server, agent, container, operator installInstallation
Backup/restore jobs, S3 and database targets, hook scripts, snapshot mounts, verification, tape migrationUsage
NFS/SMB serving endpoints for mounted snapshotsOutposts
Read/write FUSE mount for PBS archivespxar-mount
K8s operator for annotated PVCsKubernetes Operator
CI workflows and E2E testingDevelopment

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.

License

MIT