Usage

Convert LevelDB to PebbleDB

pebblify level-to-pebble [options] <source-dir> <output-dir>

Examples

pebblify level-to-pebble ~/.gaia/data ./gaia-pebble

pebblify level-to-pebble --tmp-dir /var/tmp ~/.gaia/data ./gaia-pebble

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
`--health`	Enable HTTP health probe server
`--health-port P`	Health probe port (default: 8086)
`--metrics`	Enable Prometheus metrics exporter
`--metrics-port P`	Prometheus metrics port (default: 9090)

Shell Completion

Generate and install shell completion scripts for bash or zsh.

pebblify completion bash
pebblify completion zsh
pebblify completion install

See the Shell Completion page for details.

Version Information

pebblify --version

Performance Tips

tip

Follow these recommendations for optimal conversion speed.

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