Troubleshooting and Repair

This module gives you practical troubleshooting steps for checks, lock cleanup, and repairs.

Debug Order

Most issues resolve fastest in this order:

1. Confirm RESTIC_REPOSITORY and RESTIC_PASSWORD_FILE
2. List snapshots
3. Run restic check (optionally subset)
4. Handle locks (restic unlock) only after checking active jobs
5. Repair (rebuild-index) only when needed

Lessons

Lesson	Outcome
Check Rebuild and Repair	Fix common index and metadata problems
Common Errors and Root Cause	Resolve backend, permission, and snapshot issues quickly

What You'll Be Able To Do After This Module

• Diagnose wrong-repository and wrong-password issues quickly
• Clear stale locks safely
• Prove the repository is healthy after repairs with a restore test