Install with the ClickHouse CLI

Install and manage local ClickHouse versions using clickhousectl, the ClickHouse CLI

Windows users: ClickHouse runs natively on Linux and macOS. On Windows, run these steps inside the Windows Subsystem for Linux (WSL).

Install ClickHouse using the ClickHouse CLI

The ClickHouse CLI (clickhousectl) helps you install and manage local ClickHouse versions, launch servers, and run queries.

1. Install the ClickHouse CLI

   curl https://clickhouse.com/cli | sh
   

   A chctl alias is also created automatically for convenience.

2. Install ClickHouse

   Install the latest stable version of ClickHouse:

   clickhousectl local install stable
   

   You can also install a specific version:

   clickhousectl local install lts             # Latest LTS release
   clickhousectl local install 25.6            # Latest 25.6.x.x
   clickhousectl local install 25.6.1.1        # Exact version
   
3. Start clickhouse-server

   clickhousectl local server start
   

   The server runs in the background. To verify it’s running:

   clickhousectl local server list
   
4. Start clickhouse-client

   clickhousectl local client
   

   You will see something like this:

   ClickHouse client version 24.5.1.117 (official build).
   Connecting to localhost:9000 as user default.
   Connected to ClickHouse server version 24.5.1.
   
   local-host :)
   

   You’re now ready to start sending SQL commands to ClickHouse!

   The Quick Start walks you through the steps for creating tables and inserting data.