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 from GitHub Releases page.

Two types of binaries are available:

1. Java-based binaries - Require Java 21+ to run (available here)
2. Native binaries - Standalone executables with no Java dependency
   • ice-native-amd64 - Dynamic binary for x86_64 Linux (requires glibc)
   • ice-native-arm64 - Dynamic binary for ARM64 Linux (requires glibc)

Usage

See examples/.

Development

Standard Build (Java-based)

Install sdkman, then

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

# optional but recommended
cp .envrc.sample .envrc
direnv allow

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

Native Image Build (Standalone)

Build standalone native binaries with no Java dependency:

# Install prerequisites
sdk env  # or ensure Java 21+ and GraalVM are available

# Build ice binary (both amd64 and arm64)
mvn -Pnative -pl ice clean package -Dmaven.test.skip=true

# The output binary is at ice/target/ice

# Docker builds
docker build -f ice/Dockerfile.native -t ice-native:amd64 .

docker build -f ice/Dockerfile.native -t ice-native:arm64 .

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.