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

> Install ClickHouse on Windows with WSL

# Install ClickHouse on Windows with WSL

# Install ClickHouse on Windows with WSL

<h2 id="requirements">
  Requirements
</h2>

<Note>
  To install ClickHouse on Windows you will need WSL (Windows Subsystem for Linux).
</Note>

<Steps>
  <Step>
    <h2 id="install-wsl">
      Install WSL
    </h2>

    Open Windows PowerShell as administrator and run the following command:

    ```bash theme={null}
    wsl --install
    ```

    You will be prompted to enter a new UNIX username and password. After you have
    entered your desired username and password you should see a message similar to:

    ```bash theme={null}
    Welcome to Ubuntu 24.04.1 LTS (GNU/Linux 5.15.133.1-microsoft-WSL2 x86_64)
    ```
  </Step>

  <Step>
    <h2 id="install-clickhouse-via-script-using-curl">
      Install ClickHouse via script using curl
    </h2>

    Run the following command to install ClickHouse via script using curl:

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

    If the script has successfully run you will see the message:

    ```bash theme={null}
    Successfully downloaded the ClickHouse binary, you can run it as:
      ./clickhouse
    ```
  </Step>

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

    `clickhouse-local` allows you to process local and remote files using ClickHouse's
    powerful SQL syntax and without the need for configuration. Table data is stored
    in a temporary location, meaning that after a restart of `clickhouse-local`
    previously created tables are no longer available.

    Run the following command to start [clickhouse-local](/core/concepts/features/tools-and-utilities/clickhouse-local):

    ```bash theme={null}
    ./clickhouse
    ```
  </Step>

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

    Should you wish to persist data, you'll want to run `clickhouse-server`. You can
    start the ClickHouse server using the following command:

    ```bash theme={null}
    ./clickhouse server
    ```
  </Step>

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

    With the server up and running, open a new terminal window and run the following command
    to launch `clickhouse-client`:

    ```bash theme={null}
    ./clickhouse client
    ```

    You will see something like this:

    ```response theme={null}
    ./clickhouse client
    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 :)
    ```

    Table data is stored in the current directory and still available after a restart
    of ClickHouse server. If necessary, you can pass
    `-C config.xml` as an additional command line argument to `./clickhouse server`
    and provide further configuration in a configuration
    file. All available configuration settings are documented [here](/core/reference/settings/server-settings/settings) and in the
    [example configuration file
    template](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/config.xml).

    You're now ready to start sending SQL commands to ClickHouse!
  </Step>
</Steps>