ice

A suite of tools aimed at making Iceberg REST Catalogs more approachable.

• ice-rest-catalog - A Kubernetes-ready Iceberg REST catalog backed by etcd.
  Run locally with a one-liner: ice-rest-catalog -c config.yaml.

• ice - A CLI for interacting with Iceberg REST catalogs.
  Create/delete tables, insert data with ice insert -p ns1.table1 file://example.parquet, etc.

Installation

Pre-built binaries* (+ links to Docker images for ice and ice-rest-catalog) are available form GitHub Releases page.

* currently require java 21+ to run (available here).

Usage

See examples/.

Development

Install sdkman, then

git clone https://github.com/altinity/ice && cd ice

# switch to java specified in .sdkmanrc (done automatically by direnv when `allow`ed)
sdk env
  
# shows how to build, test, etc. project
./mvnw

License

Copyright (c) 2025, Altinity Inc and/or its affiliates. All rights reserved.
ice is licensed under the Apache License 2.0.

See LICENSE for more details.

Commercial Support

ice is maintained by Altinity.
Altinity offers a range of services related to ClickHouse and analytics applications on Kubernetes.

• Official website - Get a high level overview of Altinity and our offerings.
• Altinity.Cloud - Run ClickHouse in our cloud or yours.
• Altinity Support - Get Enterprise-class support for ClickHouse.
• Slack - Talk directly with ClickHouse users and Altinity devs.
• Contact us - Contact Altinity with your questions or issues.
• Free consultation - Get a free consultation with a ClickHouse expert today.