Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Maintenance

Delete a snapshot

# Delete a specific snapshot by ID
vykar snapshot delete a1b2c3d4

Delete a repository

Permanently delete an entire repository and all its snapshots.

# Interactive confirmation (prompts you to type "delete")
vykar delete

# Non-interactive (for scripting)
vykar delete --yes-delete-this-repo

Prune old snapshots

Apply the retention policy defined in your configuration to remove expired snapshots. Optionally compact the repository after pruning.

vykar prune --compact

Verify repository integrity

# Structural integrity check
vykar check

# Full data verification (reads and verifies every chunk)
vykar check --verify-data

Repair

vykar check --repair plans and applies fixes for the problems check detects: removing corrupt or dangling snapshots, dropping index entries for missing packs, and (always) rebuilding chunk refcounts from the surviving snapshots.

# Preview the repair plan without changing anything
vykar check --repair --dry-run

# Apply the repair (prompts for confirmation)
vykar check --repair

# Apply non-interactively (for scripting)
vykar check --repair --yes

The refcount rebuild also reclaims the space leak left by an interrupted backup. If a backup crashes after its index was committed but before its snapshot was written, the index keeps orphan chunk entries (and inflated refcounts) that no snapshot references. compact alone will not free these — it treats any in-index chunk as live. vykar check --repair recomputes refcounts from the surviving snapshots and drops the orphan entries; a follow-up vykar compact then reclaims the disk space.

Compact (reclaim space)

After delete or prune, blob data remains in pack files. Run compact to rewrite packs and reclaim disk space.

# Preview what would be repacked
vykar compact --dry-run

# Repack to reclaim space
vykar compact