Diagnostics & Repair
Keeping Your Repository Healthy
Crab provides a suite of diagnostic tools that help you verify repository integrity, understand errors when they occur, and recover from interrupted operations. Whether you're troubleshooting a failed push or running periodic maintenance, these tools give you visibility into both local and remote state.
Quick Diagnostics
# Run all health checks
crab doctor
# Verify remote store integrity
crab fsck
# Look up a specific error code
crab errors CRAB-E0017
# Check recent logs for details
crab logs lastTools at a Glance
| Tool | Purpose | When to use |
|---|---|---|
| Health Check | Verify configuration and connectivity | First thing when something isn't working |
| Error Codes | Look up error explanations and fixes | After encountering a CRAB-EXXXX error |
| Log Management | Inspect diagnostic logs | Debugging failures, filing bug reports |
| Integrity Check | Verify remote objects and references | Before GC, after crashes, periodic maintenance |
| Store Verification | Validate remote store consistency | Deep investigation of remote state |
| Recovery Operations | Recover from interrupted pushes | After crashes or network failures |
| Hydrate Restore | Handle archived storage classes | When hydrating files in cold storage |
| Metadata Database | Inspect and repair metadata DBs | When push/hydrate reports DB errors |
| Version Info | Check installed version | Bug reports, compatibility checks |