Docker Usage

Run Pebblify in a container with your data directories mounted.

Convert
Convert with Health & Metrics
Recover

docker run --rm \
  -v /path/to/source:/data/source:ro \
  -v /path/to/output:/data/output \
  -v /path/to/tmp:/tmp \
  ghcr.io/dockermint/pebblify:0.3.1 \
  level-to-pebble /data/source /data/output

docker run --rm \
  -v /path/to/source:/data/source:ro \
  -v /path/to/output:/data/output \
  -v /path/to/tmp:/tmp \
  -p 8086:8086 \
  -p 9090:9090 \
  ghcr.io/dockermint/pebblify:0.3.1 \
  level-to-pebble --health --metrics /data/source /data/output

docker run --rm \
  -v /path/to/source:/data/source:ro \
  -v /path/to/output:/data/output \
  -v /path/to/tmp:/tmp \
  ghcr.io/dockermint/pebblify:0.3.1 \
  recover

Docker Compose

A docker-compose.yml is provided for local testing with health probes and metrics enabled.

services:
  pebblify:
    build:
      context: .
      args:
        VERSION: dev
        REVISION: local
    ports:
      - "8086:8086"
      - "9090:9090"
    volumes:
      - ./testdata:/data
    entrypoint:
      [
        "pebblify",
        "level-to-pebble",
        "--health",
        "--health-port",
        "8086",
        "--metrics",
        "--metrics-port",
        "9090",
      ]
    command: ["/data/source", "/data/output"]
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8086/healthz/live"]
      interval: 10s
      timeout: 3s
      start_period: 5s
      retries: 3

docker compose up --build

Built-in Health Check

The Docker image includes a built-in health check that polls the liveness endpoint. When running with --health, Docker will automatically monitor the container status.