Usage
Convert LevelDB to PebbleDB
pebblify level-to-pebble [options] <source-dir> <output-dir>
Examples
# Convert a Cosmos node's data directory
pebblify level-to-pebble ~/.gaia/data ./gaia-pebble
# Use a custom temp directory (useful if /tmp is too small)
pebblify level-to-pebble --tmp-dir /var/tmp ~/.gaia/data ./gaia-pebble
# Run with 4 workers and verbose output
pebblify level-to-pebble -w 4 -v ~/.gaia/data ./gaia-pebble
Options
| Flag | Description |
|---|
-f, --force | Overwrite existing temporary state |
-w, --workers N | Max concurrent DB conversions (0 = auto, based on CPU) |
-v, --verbose | Enable verbose output |
--batch-memory M | Target memory per batch in MB (default: 64) |
--tmp-dir DIR | Directory where .pebblify-tmp/ will be created |
Version Information
pebblify --version
Performance Tips
- Use SSDs — NVMe storage significantly improves conversion speed
- Increase workers — For systems with many CPU cores, increase
-w for faster parallel processing
- Adjust batch memory — Increase
--batch-memory if you have RAM to spare
- Use local temp — If
/tmp is a tmpfs (RAM-based), use --tmp-dir to point to disk storage for large datasets
Next Steps
- Recovery — Resume interrupted conversions
- Verification — Verify data integrity after conversion