Maintenance for Backups
Verification, Pruning and Garbage Collection

Verification Jobs
What is a verification job? 

 On Proxmox Backup Server, a verification job checks all the backups you have on your datastore to ensure there hasn't been any corruption or bit rot. Usually it is best to schedule verification jobs whenever you are not backing up data to your datastore or around any downtime. 

 Setting Up a Verification Job 

 To setup a verification job, you can either login to your backup server or the TAC.GLOBAL dashboard. We advise setting up your verification job through the dashboard since you can enable email notifications for the status and runtime of your verification job. 

 Login to the dashboard here. 

 On the home page, navigate to the verification job table. 

 

 In the bottom right corner, click to add a new job. 

 

 You can set how many days you'd like the verification status to last, but once the verification outdated number of days has passed your verification job will check the backup to ensure no corruption/bit rot.

Pruning Jobs & Retention Policy
Setting Up A Prune Job 

 There are two ways you can set up/schedule a prune job. You can do it through the backup server or through the dashboard. We suggest setting it up through the dashboard. 

 

 Under there you can view, edit, run or delete any existing jobs. To add a new job, hit Add New Job under the prune job table. 

 

 Once the prune job is added, it will show up in the prune jobs table. 

 Retention Policies 

 With pruning jobs you can set how long you'd like backups to be kept for. You can define multiple rules for the retention policy and a backup can be kept if it satisfies multiple rules defined. Pruning only removes the reference of your backups to your datastore, but it doesn't remove the actual backup. Backups are only removed when a garbage collection job is run. The table below refers to all the retention policy rules that can be applied. Proxmox also has a  pruning job simulator you can use to visualize your rules. 

 

 

 

 Option 

 What it keeps 

 Example 

 

 

 

 

 keep-last 

 The N most recent backups, regardless of age 

 3 — always keep the last 3 backups 

 

 

 keep-hourly 

 One backup per hour, for N hours 

 24 — one per hour for the last day 

 

 

 keep-daily 

 One backup per day, for N days 

 7 — one per day for the last week 

 

 

 keep-weekly 

 One backup per week, for N weeks 

 4 — one per week for the last month 

 

 

 keep-monthly 

 One backup per month, for N months 

 6 — one per month for the last half-year 

 

 

 keep-yearly 

 One backup per year, for N years 

 1 — one per year, kept indefinitely if set high

Garbage Collection Jobs
Setting Up Your Garbage Collection Job 

 By default, a garbage collection job is already set for your server that runs daily. Any data that has been pruned gets removed when this job runs. 

 To edit the garbage collection job, login to the TAC.GLOBAL dashboard . On the homepage at the bottom, you should see your garbage collection job. Click Edit Job. 

 

 You can adjust the garbage collection job schedule from here.