Skip to content
Back to search

cv4pve-autosnap

Automatic snapshot tool for Proxmox VE VMs and containers with retention policies

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Corsinvest/cv4pve-autosnap with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Corsinvest/cv4pve-autosnap'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/corsinvest--cv4pve-autosnap/badge.svg)](/listings/corsinvest--cv4pve-autosnap)

HTML

<a href="/listings/corsinvest--cv4pve-autosnap"><img src="/api/listings/corsinvest--cv4pve-autosnap/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# Windows
winget install Corsinvest.cv4pve.autosnap

# Linux (other platforms and packages: see the documentation)
wget https://github.com/Corsinvest/cv4pve-autosnap/releases/latest/download/cv4pve-autosnap-linux-x64.zip
unzip cv4pve-autosnap-linux-x64.zip && chmod +x cv4pve-autosnap

# See what would happen, then take the snapshots
./cv4pve-autosnap --host=pve01 --api-token='autosnap@pve!snap=<uuid>' --vmid=@all --dry-run snap --label=daily --keep=7
./cv4pve-autosnap --host=pve01 --api-token='autosnap@pve!snap=<uuid>' --vmid=@all snap --label=daily --keep=7

Global options (`--host`, `--vmid`, `--max-parallel`, …) go **before** the command, command options after it. The API token needs the four privileges listed in [Permissions](https://corsinvest.github.io/cv4pve-autosnap/permissions/).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 123 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # <img src="icon.png" alt="" height="36" align="top"> cv4pve-autosnap
  2. ```
  3. ______ _ __
  4. / ____/___ __________(_)___ _ _____ _____/ /_
  5. / / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
  6. / /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
  7. \____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
  8. Automatic Snapshot Tool for Proxmox VE (Made in Italy)
  9. ```
  10. [![License](https://img.shields.io/github/license/Corsinvest/cv4pve-autosnap.svg?style=flat-square)](LICENSE.md)
  11. [![Release](https://img.shields.io/github/release/Corsinvest/cv4pve-autosnap.svg?style=flat-square)](https://github.com/Corsinvest/cv4pve-autosnap/releases/latest)
  12. [![Downloads](https://img.shields.io/github/downloads/Corsinvest/cv4pve-autosnap/total.svg?style=flat-square&logo=download)](https://github.com/Corsinvest/cv4pve-autosnap/releases)
  13. [![NuGet](https://img.shields.io/nuget/v/Corsinvest.ProxmoxVE.AutoSnap.Api.svg?style=flat-square&logo=nuget)](https://www.nuget.org/packages/Corsinvest.ProxmoxVE.AutoSnap.Api/)
  14. [![WinGet](https://img.shields.io/winget/v/Corsinvest.cv4pve.autosnap?style=flat-square&logo=windows)](https://winstall.app/apps/Corsinvest.cv4pve.autosnap)
  15. [![AUR](https://img.shields.io/aur/version/cv4pve-autosnap?style=flat-square&logo=archlinux)](https://aur.archlinux.org/packages/cv4pve-autosnap)
  16. > **Automatic snapshots of Proxmox VE VMs and containers, with retention**: one command takes a snapshot of the guests you choose and removes the oldest ones, so every label keeps exactly the number you set.
  17. >
  18. > **[Documentation](https://corsinvest.github.io/cv4pve-autosnap/)**
  19. >
  20. > Prefer a web interface with schedules, run history and webhooks? cv4pve-autosnap also runs inside [cv4pve-admin](https://github.com/Corsinvest/cv4pve-admin), as its [AutoSnap](https://corsinvest.github.io/cv4pve-admin/modules/autosnap/) module.
  21. ---
  22. ## Why
  23. A snapshot is the quickest way back after a broken upgrade or a bad change inside a guest. Proxmox VE takes one in a click, but only when someone remembers to click, and it never removes the old ones.
  24. cv4pve-autosnap takes the snapshot of every guest you select and removes the oldest ones of the same label: *every two hours, keep 10* stays at ten snapshots per guest. Run it from cron or the Task Scheduler, or right before an upgrade.
  25. It **runs outside the nodes and uses only the Proxmox VE API**: nothing to install on the cluster, no SSH, no root shell.
  26. > **A snapshot is not a backup.** It lives on the same storage as the disk: if the storage is lost, so are its snapshots. Keep your [Proxmox VE backups](https://pve.proxmox.com/wiki/Backup_and_Restore).
  27. ---
  28. ## What it looks like
  29. ```
  30. $ cv4pve-autosnap --host=pve01 --api-token='autosnap@pve!snap=…' --vmid=@all status
  31. +-------+------+-------------------+-------------------------+-------------------------+-----------------+-----------+
  32. | NODE | VM | TIME | PARENT | NAME | DESCRIPTION | VM STATUS |
  33. +-------+------+-------------------+-------------------------+-------------------------+-----------------+-----------+
  34. | pve01 | 105 | 26/09/28 07:00:02 | before-upgrade | auto2hourly260928070002 | cv4pve-autosnap | |
  35. | pve01 | 105 | 26/09/28 09:00:04 | auto2hourly260928070002 | auto2hourly260928090004 | cv4pve-autosnap | |
  36. | pve01 | 1000 | 26/09/28 07:00:03 | no-parent | auto2hourly260928070002 | cv4pve-autosnap | |
  37. | pve02 | 203 | 26/09/28 07:00:57 | no-parent | auto2hourly260928070002 | cv4pve-autosnap | |
  38. +-------+------+-------------------+-------------------------+-------------------------+-----------------+-----------+
  39. ```
  40. ---
  41. ## Features
  42. - **Retention per label**: `hourly`, `daily`, `weekly` or any name: each label keeps its own number of snapshots per guest.
  43. - **Choose the guests**: by ID, name, range, node, pool or tag, with exclusions; resolved at every run, so a migrated or newly tagged guest is picked up with no change.
  44. - **Storage guard**: a guest is skipped when a storage holding its disks is used above 95% (or your threshold).
  45. - **Hook scripts**: your script runs at every phase, with guest, label and result in environment variables; ready-made templates and a metrics sender in [hooks/](hooks/).
  46. - **Consistent snapshots**: optional RAM state with `--state`; warns when a VM has the QEMU guest agent off.
  47. - **Parallel**: several guests at the same time with `--max-parallel`.
  48. - **Dry run**: `--dry-run` shows what would be created and removed.
  49. - **Keeps running with a node down**: give it more than one host and it uses the first that answers.
  50. ---
  51. ## Quick start
  52. ```bash
  53. # Windows
  54. winget install Corsinvest.cv4pve.autosnap
  55. # Linux (other platforms and packages: see the documentation)
  56. wget https://github.com/Corsinvest/cv4pve-autosnap/releases/latest/download/cv4pve-autosnap-linux-x64.zip
  57. unzip cv4pve-autosnap-linux-x64.zip && chmod +x cv4pve-autosnap
  58. # See what would happen, then take the snapshots
  59. ./cv4pve-autosnap --host=pve01 --api-token='autosnap@pve!snap=<uuid>' --vmid=@all --dry-run snap --label=daily --keep=7
  60. ./cv4pve-autosnap --host=pve01 --api-token='autosnap@pve!snap=<uuid>' --vmid=@all snap --label=daily --keep=7
  61. ```
  62. Global options (`--host`, `--vmid`, `--max-parallel`, …) go **before** the command, command options after it. The API token needs the four privileges listed in [Permissions](https://corsinvest.github.io/cv4pve-autosnap/permissions/).
  63. ---
  64. ## Documentation
  65. | | |
  66. |---|---|
  67. | [Getting started](https://corsinvest.github.io/cv4pve-autosnap/getting-started/) | Install, connect, first run |
  68. | [Permissions](https://corsinvest.github.io/cv4pve-autosnap/permissions/) | Creating the user and API token, required privileges |
  69. | [Choosing guests](https://corsinvest.github.io/cv4pve-autosnap/guests/) | IDs, names, pools, tags, nodes, exclusions |
  70. | [Labels and retention](https://corsinvest.github.io/cv4pve-autosnap/retention/) | Snapshot names, `--keep`, `clean`, `status` |
  71. | [Scheduling](https://corsinvest.github.io/cv4pve-autosnap/scheduling/) | cron, Task Scheduler, parameter files |
  72. | [Snapshot consistency](https://corsinvest.github.io/cv4pve-autosnap/consistency/) | `--state`, QEMU guest agent, fsfreeze hooks for databases |
  73. | [Hook scripts](https://corsinvest.github.io/cv4pve-autosnap/hooks/) | Phases, variables, ready-made scripts |
  74. | [Commands](https://corsinvest.github.io/cv4pve-autosnap/commands/) | Every option, defaults, exit codes |
  75. | [AI assistants](https://corsinvest.github.io/cv4pve-autosnap/ai-agents/) | Claude Code, Codex, the `cv4pve-autosnap` skill |
  76. | [Troubleshooting](https://corsinvest.github.io/cv4pve-autosnap/troubleshooting/) | What the messages mean, debug output |
  77. ---
  78. ## Related tools
  79. Use `cv4pve-autosnap` for recent restore points of the guests, [cv4pve-node-protect](https://github.com/Corsinvest/cv4pve-node-protect) to save the configuration of the nodes. The whole suite: [corsinvest.it/cv4pve](https://www.corsinvest.it/en/cv4pve/).
  80. ---
  81. ## Support
  82. Professional support and consulting available through [Corsinvest](https://www.corsinvest.it/en/cv4pve/).
  83. ---
  84. **By sysadmins, for sysadmins.**
  85. Part of [cv4pve](https://www.corsinvest.it/en/cv4pve/) suite | Made with ❤️ in Italy by [Corsinvest](https://www.corsinvest.it)
  86. Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. cv4pve is developed by Corsinvest and is not a Proxmox product.
  87. Copyright © Corsinvest Srl

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.