Kopia¶
Recipes for managing Kopia backups. Kopia must already be connected to a repository (kopia repository connect ...)
before these recipes will work.
Checking Status¶
status shows whether Kopia is connected to a repository and which backend is configured (filesystem, S3, B2, etc.).
Run this first if anything else fails — most errors trace back to a disconnected repo.
Snapshots¶
list-snapshots shows all snapshots across all sources. Look at the timestamps and sizes to confirm backups are running
on schedule.
create takes a manual snapshot of a path. Useful for ad-hoc backups before risky changes:
just kopia create ~/projects/important.
verify checks snapshot integrity — reads snapshot metadata and verifies object checksums. Run this periodically or
after recovering from a storage issue. A clean run means your backups are restorable.
Policies¶
Policies control retention (how many snapshots to keep), scheduling, compression, and which files to exclude.
list-policies shows all policies. show-policy shows the effective policy for a specific path — this merges inherited
policies from parent directories with any overrides.
edit-policy opens the policy JSON in your editor. Common things to tweak: retention counts, file ignore patterns, and
compression settings.
Common Workflows¶
"Are my backups working?":
just kopia status— connected?just kopia list-snapshots— recent snapshots present?just kopia verify— data intact?
"I need to back up before a big change":