Project Antalya Concepts Guide
What is Project Antalya, why did we build it, and how do I set it up?
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.
The project was designed to solve major challenges facing analytics workloads today:
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.
Project Antalya contains cutting edge features. Some features may be experimental, so check the product documentation to be sure.
Also, Antalya builds contain interserver protocol changes that are not compatible across release families or with some upstream ClickHouse releases. All nodes participating in distributed queries - including coordinators, replicas, and swarm workers — must run the same version of Antalya.
To upgrade to a new version of Antalya, stop all the cluster nodes participating in distributed workloads, upgrade them together, then restart the workloads. Using different versions of Antalya together or performing a rolling upgrade that temporarily mixes versions may cause distributed object-storage and Iceberg queries to fail or return incorrect results.
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:
| Release Notes | Build Status | Latest Version | Release Date | Support Duration | Support End-of-Life |
|---|---|---|---|---|---|
| 26.6 | Available | 26.6.4.20001 | 11 Sep 2026 | 6 months | 26 Feb 2027 |
| 26.3 | Available | 26.3.13.20001 | 3 Jul 2026 | 6 months | 3 Jan 2027 |
| 26.1 | Available | 26.1.11.20001 | 4 Apr 2026 | 6 months | 4 Oct 2026 |
| 25.8 | Available | 25.8.33.20001 | 10 Oct 2025 | 6 months | 5 Nov 2026 |
| 25.6 | Available | 25.6.5.20420 | 2 Oct 2025 | 6 months | 2 Apr 2026 |
| 25.3 | Available | 25.3.3.20186 | 14 Jul 2025 | 6 months | 14 Jan 2026 |
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.6.4.20001 for the 26.6 branch (release notes), 26.3.13.20001 for the 26.3 branch (release notes), and 25.8.33.20001 for the 25.8 branch (release notes). See the release notes for all 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:
What is Project Antalya, why did we build it, and how do I set it up?
Getting up to speed with Project Antalya
How to use ClickHouse® with an OAuth provider
The technical details you’ll need to make the most of Antalya