Backup¶

This guide covers operating and managing Proxmox Backup Server (PBS) for your TAPPaaS infrastructure. For installation, see the Backup Installation guide.

Available Scripts¶

Script	Purpose
`install.sh`	Deploy PBS and configure components
`restore.sh`	Restore VMs from backups
`backup-manage.sh`	Operational management tasks

Backup Operations¶

Check Status¶

./backup-manage.sh status

List Backup Jobs¶

./backup-manage.sh list

Run Immediate Backup¶

# Backup specific VM
./backup-manage.sh backup 100

# Backup all VMs
./backup-manage.sh backup-all

Prune Old Backups¶

./backup-manage.sh prune

Garbage Collection¶

Reclaim storage space:

./backup-manage.sh gc

Restoration¶

Restore Latest Backup¶

./restore.sh <vmid>

Restore Options¶

# Restore to specific node
./restore.sh <vmid> --node tappaas2

# Restore to different storage
./restore.sh <vmid> --storage tanka1

# Restore specific snapshot
./restore.sh <vmid> --snapshot backup/vm/100/2024-01-15T10:30:00Z

Web Interface¶

Access the PBS dashboard:

https://pbs.mgmt.internal:8007

Authentication options:

Account	Type
`root@pam`	Linux system root
`tappaas@pbs`	Dedicated backup user

Retention Policy¶

Default retention settings:

Policy	Value	Coverage
Keep Last	4	Most recent backups
Keep Daily	14	Two weeks of daily
Keep Weekly	8	Two months of weekly
Keep Monthly	12	One year of monthly
Keep Yearly	6	Six years of yearly

Modify Retention¶

To adjust retention policies, edit the datastore configuration in the PBS web interface or via CLI.

Backup Schedule¶

By default, backups run:

Daily at 2:00 AM
Includes all VMs and containers
Prune runs after backup completion

Modify Schedule¶

Edit the backup job in Proxmox:

Navigate to Datacenter → Backup
Select the backup job
Modify schedule as needed

Monitoring¶

Check Backup Health¶

# View recent tasks
./backup-manage.sh tasks

# Check datastore usage
./backup-manage.sh usage

Alerts¶

Configure email alerts in PBS:

Navigate to Configuration → Notifications
Add email recipient
Configure notification rules

Verification¶

Regularly verify backups:

# Verify backup integrity
./backup-manage.sh verify

# Test restore (creates temporary clone)
./backup-manage.sh test-restore 100

Troubleshooting¶

Backup Fails¶

Check disk space: ./backup-manage.sh usage
Verify VM is running: qm status <vmid>
Check PBS logs: journalctl -u proxmox-backup-proxy

Restore Fails¶

Verify backup exists: ./backup-manage.sh list
Check target storage capacity
Review PBS task logs

Security Considerations¶

PBS uses encrypted connections
Consider enabling backup encryption for sensitive data
Restrict tappaas@pbs permissions appropriately
Store encryption keys securely off-site