[pve-devel] [PATCH docs] backup: add section for protection

Fabian Ebner f.ebner at proxmox.com
Tue Nov 16 15:44:28 CET 2021

Signed-off-by: Fabian Ebner <f.ebner at proxmox.com>
 vzdump.adoc | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/vzdump.adoc b/vzdump.adoc
index 96ae70d..f766d36 100644
--- a/vzdump.adoc
+++ b/vzdump.adoc
@@ -284,6 +284,19 @@ We recommend that you use a higher retention period than is minimally required
 by your environment; you can always reduce it if you find it is unnecessarily
 high, but you cannot recreate backups once they have been removed.
+Backup Protection
+You can mark a backup as `protected` to prevent its removal. Attempting to
+remove a protected backup via {pve}'s UI or API will fail. However, manual
+removal of a backup file via CLI is still possible. Protected backups are
+ignored by pruning and do not count towards the retention settings.
+For filesystem-based storages, the protection is implemented via a sentinel file
+`<backup-name>.protected`. For Proxmox Backup Server, it is handled on the
+server side.

More information about the pve-devel mailing list