> ## 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.

> Instala y administra versiones locales de ClickHouse con clickhousectl, la ClickHouse CLI

# Instalar con la ClickHouse CLI

<Info>
  **Usuarios de Windows**

  ClickHouse se ejecuta de forma nativa en Linux y macOS. En Windows, ejecuta estos pasos dentro de
  [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/about).
</Info>

La ClickHouse CLI (`clickhousectl`) te ayuda a instalar y administrar versiones locales de ClickHouse,
iniciar servidores y ejecutar consultas.

<Steps>
  <Step>
    ## Instala la ClickHouse CLI

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

    También se crea automáticamente un alias `chctl` para mayor comodidad.
  </Step>

  <Step>
    ## Instala ClickHouse

    Instala la versión más reciente de ClickHouse y conviértela en la predeterminada:

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

    `local use` instala la versión si aún no está presente, la establece como
    predeterminada y crea un enlace simbólico `clickhouse` en `~/.local/bin` (en tu `PATH`)
    para que puedas invocar directamente el binario `clickhouse`. Así, cualquier paso posterior de esta documentación
    que ejecute un comando `clickhouse` funcionará tal cual.

    También puedes seleccionar una versión específica:

    ```bash theme={null}
    clickhousectl local use 26.5            # Última 26.5.x.x
    clickhousectl local use 26.5.2.39       # Versión exacta
    ```

    <Info>
      **Use vs install**

      `clickhousectl local use <version>` instala una versión *y* la convierte en tu
      predeterminada, actualizando el enlace simbólico `clickhouse` en tu `PATH`. Para descargar una versión
      sin cambiar la predeterminada ni actualizar el enlace simbólico, usa
      `clickhousectl local install <version>` en su lugar.
    </Info>
  </Step>

  <Step>
    ## Inicia clickhouse-server

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

    El servidor se ejecuta en segundo plano. Para verificar que está en ejecución:

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

  <Step>
    ## Inicia clickhouse-client

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

    Verás algo como esto:

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

    ¡Ya estás listo para empezar a enviar comandos SQL a ClickHouse!

    <Tip>
      La [Quick Start](/es/get-started/setup/install) te guía por los pasos para crear tablas e insertar datos.
    </Tip>
  </Step>
</Steps>
