Browse documentation
CROWDB / DOCUMENTATION

Iceberg quick start

Start the Iceberg container, then follow the supported table workflow.

DEVELOPMENT PREVIEW · OCTOBER 2, 2026

Start with the single-node container guide for deployment, credentials, and persistence, then use the Iceberg table guide for the complete create/append/pandas example and supported API scope.

Start Iceberg

docker run -d --name crowdb-iceberg \
  -p 127.0.0.1:9092:9092 \
  -v crowdb-iceberg-data:/opt/crowdb/data \
  --stop-timeout 120 \
  crowdb/crowdb-iceberg:latest
docker inspect --format '{{.State.Health.Status}}' crowdb-iceberg

Wait for healthy, then retrieve ICEBERG_URI and ICEBERG_TOKEN:

docker exec crowdb-iceberg crowdb-monitor credentials show --format env

The catalog and native FileIO use http://localhost:9092. Copy those values into your client environment. Follow the PyIceberg example to create a table, append rows, and read them into pandas.

Next steps

This is a Linux amd64 development preview for disposable data. Use the updated 909x image configuration; older tags may use different ports. No production or cross-version volume upgrade guarantee is provided.