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

> Instale e gerencie versões locais do ClickHouse usando clickhousectl, a ClickHouse CLI

# Instalar com a ClickHouse CLI

<Info>
  **Usuários do Windows**

  O ClickHouse roda nativamente em Linux e macOS. No Windows, execute estas etapas dentro do
  [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/about).
</Info>

A ClickHouse CLI (`clickhousectl`) ajuda você a instalar e gerenciar versões locais do ClickHouse,
iniciar servidores e executar consultas.

<Steps>
  <Step>
    ## Instale a ClickHouse CLI

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

    Um alias `chctl` também é criado automaticamente para sua conveniência.
  </Step>

  <Step>
    ## Instale o ClickHouse

    Instale a versão mais recente do ClickHouse e defina-a como padrão:

    ```bash theme={null}
    clickhousectl local use latest
    ```

    `local use` instala a versão, caso ela ainda não esteja presente, define-a como
    padrão e cria um symlink `clickhouse` em `~/.local/bin` (no seu `PATH`)
    para que você possa invocar diretamente o binário `clickhouse`. Assim, qualquer etapa posterior nesta documentação
    que execute um comando `clickhouse` funcionará sem alterações.

    Você também pode selecionar uma versão específica:

    ```bash theme={null}
    clickhousectl local use 26.5            # Latest 26.5.x.x
    clickhousectl local use 26.5.2.39       # Exact version
    ```

    <Info>
      **Use vs install**

      `clickhousectl local use <version>` instala uma versão *e* a define como
      padrão, atualizando o symlink `clickhouse` no seu `PATH`. Para baixar uma versão
      sem alterar a versão padrão nem atualizar o symlink, use
      `clickhousectl local install <version>`.
    </Info>
  </Step>

  <Step>
    ## Inicie o clickhouse-server

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

    O servidor é executado em segundo plano. Para verificar se ele está em execução:

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

  <Step>
    ## Inicie o clickhouse-client

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

    Você verá algo assim:

    ```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 :)
    ```

    Agora você já pode começar a enviar comandos SQL ao ClickHouse!

    <Tip>
      O [Quick Start](/pt-BR/get-started/setup/install) orienta você nas etapas para criar tabelas e inserir dados.
    </Tip>
  </Step>
</Steps>