How-to
Troubleshoot common PBS errors fast.
Quick checks to clear fingerprint/auth issues, verify errors, and performance bottlenecks before they impact backups.
Steps
- Fingerprint or cert errors. Re-fetch and approve the correct TLS fingerprint; ensure time sync and valid cert chain.
- Auth or permission denied. Verify user/token scope to the datastore/namespace; rotate credentials if in doubt.
- Verify/chunk errors. Re-run verify; if persistent, re-backup the affected guest. Check storage health (ZFS, SMART).
- Performance slowdowns. Reduce concurrency, check I/O latency, and confirm no overlap with prune/GC/verify.
- Network issues. Test connectivity and MTU; ensure firewall rules allow PBS ports from Proxmox VE nodes.
- Review logs. Inspect PBS and PVE logs for error codes; correlate with job IDs and timestamps.
Prereqs
- Access to PBS/PVE logs
- Valid credentials and fingerprint
- Monitoring for storage and network
Quick checks
- Jobs run without auth or fingerprint prompts.
- Verify passes; no new chunk errors appear.
- Throughput back to normal ranges.
- Network/firewall confirms expected paths open.
If something fails
- Rotate tokens; re-approve fingerprint.
- Re-backup affected guests after verify errors.
- Lower concurrency and reschedule around prune/verify.
- Check storage health (ZFS status, SMART) and network MTU.
Related guides
Official docs
Proxmox troubleshooting references: PBS troubleshooting guide.
Hosted PBS at $7.95/TB.
No storage limits—$7.95/TB with compute and RAM included. We run the infrastructure; you keep control.