Skip to content

puddle

A Go implementation of the Apache Iceberg REST catalog spec. Single binary, small surface, validated against the Iceberg REST Compatibility Kit.

This site is the operator-facing reference. Source and issues live on GitHub; the README there has the project overview and a quick start.

Start here

  • Configuration — every block of the YAML config file: server, logging, metastore, warehouses, authentication, authorization.
  • Credential vending — STS AssumeRole for per-table, prefix-scoped object-storage credentials against AWS, MinIO, and Ceph RGW.

Versions

Each CalVer release publishes its own copy of these docs. The repo’s Pages root redirects to the newest release; older releases stay reachable at their versioned paths.