infra-proxmox-bindsnap

Installs and operates pve-bindsnap to snapshot and clone Proxmox LXC containers with bind mounts.

1|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/bitranox/bitranox-skills --skill infra-proxmox-bindsnap-bitranox
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: infra-proxmox-bindsnap
Source: https://github.com/bitranox/bitranox-skills/tree/main/plugins/bitranox/skills/infra-proxmox-bindsnap
Command: npx skills add https://github.com/bitranox/bitranox-skills --skill infra-proxmox-bindsnap-bitranox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Stock Proxmox VE refuses to snapshot or clone LXC containers that carry bind or device mounts: the GUI snapshot button is greyed out and pct clone fails with "unable to clone mountpoint 'mpN' (type bind)". This Skill guides installing, verifying, and operating pve-bindsnap, a Perl overlay that delegates to Proxmox's real snapshot and clone code so bind-mount containers can be snapshotted and cloned. ## Core Features & Use Cases - Install and verify the overlay: Run the idempotent install script on the Proxmox node, then confirm activation via journalctl or a Perl check of $APPLIED and $CLONE_APPLIED. - Control snapshot and clone behavior with markers: Use BINDSNAP-FORCE-RUNNING for running containers, BINDSNAP-UNSUPPORTED for untested pve-container builds, and BINDSNAP-EXCLUDE: mpN to keep managed volumes out of snapshots or bind mounts out of clones. - Handle the checksum guard: Diagnose TEST mode on untested builds, opt in once, run the test plan, and report checksums so the build joins the known-good list. - Use Case: You need scheduled snapshots of a container whose mp0 bind mount points at host storage. After installing pve-bindsnap and adding BINDSNAP-FORCE-RUNNING to the CT Notes, your scheduler snapshots it like any other container. ## Quick Start Ask the assistant to install pve-bindsnap on your Proxmox node and verify that snapshot and clone now work for your bind-mount container.

Frequently Asked Questions about infra-proxmox-bindsnap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I snapshot a Proxmox LXC container with bind mounts?▼

Install pve-bindsnap on the Proxmox node, which dpkg-diverts PVE::LXC::Config so bind-mount containers pass the snapshot gate. After verifying activation in the pvedaemon journal, run pct snapshot <vmid> <name> on a stopped container as usual.

How to fix "unable to clone mountpoint 'mpN' (type bind)" in Proxmox?▼

This error means the clone path refuses bind mounts. Install pve-bindsnap, which overlays PVE::API2::LXC so pct clone works and carries each bind mount to the clone pointing at the same host path. On untested pve-container builds the clone stays stock until the build is vetted.

Can I snapshot a running Proxmox container with bind mounts?▼

Yes, but a running container is refused by default because the filesystem freeze can stall on FUSE or CIFS mounts. Add the BINDSNAP-FORCE-RUNNING keyword to the snapshot description or as a standing line in the CT Notes to opt in.

Does a Proxmox snapshot include bind mount data?▼

No. Only the mount setting in the container config is captured; the host data behind a bind or device mount is never snapshotted, cloned, or rolled back. Rollback rewinds managed volumes like rootfs, while bind-mount host data stays untouched.

Why does pve-bindsnap say my pve-container build is untested?▼

The overlay checksums the upstream Proxmox source and only activates fully on vetted builds. On an untested build, opt in once with BINDSNAP-UNSUPPORTED, run the test plan, and report the version and checksum so the build joins the known-good list.

When should I not use pve-bindsnap?▼

Containers without bind or device mounts already snapshot and clone stock, so the overlay adds nothing. If you only need a rootfs snapshot of a stopped container without GUI or scheduler integration, a direct zfs snapshot of the subvol is simpler.