> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# Install with the ClickHouse CLI

<Info>
  **Windows users**

  ClickHouse runs natively on Linux and macOS. On Windows, run these steps inside
  the [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/about).
</Info>

# Install ClickHouse using the ClickHouse CLI

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

<Steps>
  <Step>
    <h2 id="install-the-cli">
      Install the ClickHouse CLI
    </h2>

    ```bash theme={null}
    curl https://clickhouse.com/cli | sh
    ```

    A `chctl` alias is also created automatically for convenience.
  </Step>

  <Step>
    <h2 id="cli-install-clickhouse">
      Install ClickHouse
    </h2>

    Install the latest stable version of ClickHouse:

    ```bash theme={null}
    clickhousectl local install stable
    ```

    You can also install a specific version:

    ```bash theme={null}
    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
    ```
  </Step>

  <Step>
    <h2 id="cli-start-clickhouse-server">
      Start clickhouse-server
    </h2>

    ```bash theme={null}
    clickhousectl local server start
    ```

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

    ```bash theme={null}
    clickhousectl local server list
    ```
  </Step>

  <Step>
    <h2 id="cli-start-clickhouse-client">
      Start clickhouse-client
    </h2>

    ```bash theme={null}
    clickhousectl local client
    ```

    You will see something like this:

    ```response theme={null}
    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!

    <Tip>
      The [Quick Start](/get-started/setup/install) walks you through the steps for creating tables and inserting data.
    </Tip>
  </Step>
</Steps>