Documentation

History & Rollback

Browse snapshots and restore previous versions

How Snapshots Work

Every push creates a timestamped snapshot stored in Cloudflare R2. Snapshots are immutable — they capture the full encrypted state at that point in time.

Viewing History

Terminal

# List recent snapshots

configsync history

# Limit results

configsync history --limit 5

# View history from a specific machine

configsync history --from work-macbook

--limit <n>	Number of snapshots to show (default: 20)
--from <machine>	Filter snapshots by source machine

Restoring a Snapshot

Use the snapshot ID from history output to restore a specific version.

Terminal

# Preview what would change

configsync pull --snapshot snap_abc123 --dry-run

# Restore it

configsync pull --snapshot snap_abc123

Always use --dry-run first to preview what a snapshot restore will change before applying it.

Combining with Filters

You can combine snapshot restore with --filter to roll back only specific items.

Terminal

# Restore only SSH config from a snapshot

configsync pull --snapshot snap_abc123 --filter modules:ssh

# Restore only env files from a snapshot

configsync pull --snapshot snap_abc123 --filter env_files