prune.cfg(5)

PRUNE.CFG(5) Proxmox Backup PRUNE.CFG(5)

NAME

prune.cfg - Prune Job Configuration

DESCRIPTION

The file /etc/proxmox-backup/prune.cfg is a configuration file for Proxmox Backup Server. It contains the prune job configuration.

FILE FORMAT

Each entry starts with the header prune: <name>, followed by the job configuration options.

prune: prune-store2

schedule mon..fri 10:30
store my-datastore prune: ...


You can use the proxmox-backup-manager prune-job command to manipulate this file.

OPTIONS

Required properties:

schedule (<calendar-event>)
Run prune job at specified schedule.
store (<string>)
Datastore name.

Optional properties:

comment (<string>)
Comment.
disable (<boolean> (default=false))
Disable this job.
max-depth (<integer> (0 - 7))
How many levels of namespaces should be operated on (0 == no recursion, empty == automatic full recursion, namespace depths reduce maximum allowed value)
ns (<string>)
Namespace.
keep-daily (<integer> (1 - N))
Number of daily backups to keep.
keep-hourly (<integer> (1 - N))
Number of hourly backups to keep.
keep-last (<integer> (1 - N))
Number of backups to keep.
keep-monthly (<integer> (1 - N))
Number of monthly backups to keep.
keep-weekly (<integer> (1 - N))
Number of weekly backups to keep.
keep-yearly (<integer> (1 - N))
Number of yearly backups to keep.

COPYRIGHT AND DISCLAIMER

Copyright (C) 2019-2025, Proxmox Server Solutions GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <http://www.gnu.org/licenses/>

Author

Proxmox Support Team

Copyright

2019-2025, Proxmox Server Solutions GmbH

Thursday, 21 May 2026 <devbuild>