Project Antalya

In a nutshell, Project Antalya integrates open-source ClickHouse® and data lakes to lower costs, simplify scaling, and reduce operational complexity in real-time analytic applications. It is 100% compatible with upstream ClickHouse, and many Antalya features have been submitted as PRs.

Key Challenges of Analytics Systems

The project was designed to solve major challenges facing analytics workloads today:

• Soaring Storage Costs - Block storage with replication is 10x more expensive than object storage.
  • Antalya adds the option to work with data lakes hosted on inexpensive, S3-compatible storage in addition to existing MergeTree storage.
    
• Inefficient Use of Compute - Overprovisioning to ingest data and run queries in single processes wastes compute resources.
  
  • Antalya’s swarm clusters are clusters of stateless ClickHouse servers that eliminate the need to overprovision compute nodes.
    
• Complex Operations - Large clusters of stateful servers scale slowly and are hard to manage.
  • Antalya’s swarm clusters manage themselves and scale up or down quickly.

Real-Time Data Lakes with Project Antalya

Project Antalya extends open source ClickHouse to bring the power of real-time query to the low cost and outstanding scalability of Apache Iceberg-based data lakes.

• Boost I/O and caching of Parquet to match MergeTree performance
• Deliver sub-second query on data lakes with stateless, cheap swarm clusters
• Hybrid tables - Query MergeTree data and Iceberg data with a single SQL statement
• Archive MergeTree data automatically to Iceberg data (in development; see the 2026 project roadmap for details)
• Integrate popular cloud services such as AWS Glue Data Catalogs and AWS S3 Table Buckets.

Antalya Releases

👉 Project Antalya contains cutting edge features. Some features may be experimental, so check product docs to be sure.

Because Antalya development is progressing rapidly, Altinity currently offers support for the latest two releases for six months beyond their first release. In addition, we will support Antalya 25.8 for more than six months based on customer demand. Going forward, support will be offered for x.3 and x.8 releases. A more formal release schedule and support policy will be available in the second half of 2026.

Here are links to the details of all Antalya releases:

You can find the project roadmap (for 2026 and 2025) in the Antalya branch of Altinity's ClickHouse repo.

The latest releases are version 26.3.10.20001 for the 26.3 branch (release notes) and 25.8.22.20001 for the 25.8 branch (release notes). See the release notes for all the details.

The details

The following pages explain the concepts behind Project Antalya, as well as the configuration settings to enable them and the SQL syntax to access them: