# Snapshot Runbook — Before Major Changes

**Last Updated:** 2026-02-07  
**Purpose:** Create Proxmox snapshots before major changes for quick rollback.  
**See:** [OPERATIONAL_RUNBOOKS.md](OPERATIONAL_RUNBOOKS.md), [PRE_START_CHECKLIST.md](PRE_START_CHECKLIST.md)

---

## When to Create Snapshots

- Before upgrading Besu or other critical services
- Before configuration changes (nginx, NPMplus, etc.)
- Before OS/package upgrades in containers
- Before migration (storage, host, network)

---

## Commands

### LXC (containers)

```bash
# Create snapshot (use pct on Proxmox host)
pct snapshot <VMID> pre-<change>-$(date +%Y%m%d-%H%M%S)

# Examples
pct snapshot 1000 pre-besu-upgrade-20260207
pct snapshot 10233 pre-npmplus-config-20260207-120000

# List snapshots
pct listsnapshot <VMID>

# Rollback (if needed)
pct rollback <VMID> pre-<change>-YYYYMMDD
```

### QEMU/KVM (VMs)

```bash
qm snapshot <VMID> pre-<change>-$(date +%Y%m%d)
qm listsnapshot <VMID>
qm rollback <VMID> pre-<change>-YYYYMMDD
```

### Via SSH from repo

```bash
# From project root
source config/ip-addresses.conf

# Create snapshot on r630-01 for VMID 10233
ssh root@$PROXMOX_R630_01 "pct snapshot 10233 pre-change-$(date +%Y%m%d-%H%M%S)"
```

---

## Retention

- Keep 1–3 recent snapshots per VMID
- Delete old snapshots: `pct delsnapshot <VMID> <snapname>`
- Snapshots consume storage; monitor disk usage

---

## Checklist

- [ ] Identify VMIDs affected by change
- [ ] Create snapshot on each Proxmox host for those VMIDs
- [ ] Document snapshot names for rollback reference
- [ ] Proceed with change
- [ ] If rollback needed: `pct rollback <VMID> <snapname>`