Recovery

If a conversion is interrupted (crash, power loss, etc.), Pebblify can resume from the last checkpoint.

Resume a Conversion

pebblify recover [options]

Examples

# Resume with default temp directory
pebblify recover

# Resume with custom temp directory (must match the original conversion)
pebblify recover --tmp-dir /var/tmp

Options

FlagDescription
-w, --workers NMax concurrent DB conversions (0 = auto)
-v, --verboseEnable verbose output
--tmp-dir DIRDirectory containing .pebblify-tmp/

How Recovery Works

Pebblify maintains a state file at .pebblify-tmp/state.json that tracks:

  • Source and destination paths
  • Status of each database (pending, in_progress, done, failed)
  • Last checkpoint key for each database
  • Migration statistics and metrics

When you run recover, Pebblify reads this state file and resumes conversion from the last successfully checkpointed key in each database, skipping any databases that were already completed.

Next Steps

  • Verification — Verify data integrity after conversion
  • Usage — Full conversion options reference