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-2026, Proxmox Server Solutions GmbH

Wednesday, 06 May 2026 <devbuild>