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

> Instalar ClickHouse en Linux Debian/Ubuntu

# Instalar ClickHouse en Debian/Ubuntu

<div id="install-from-deb-packages">
  # Instalar ClickHouse en Debian/Ubuntu
</div>

> Se recomienda usar paquetes `deb` oficiales precompilados para **Debian** o **Ubuntu**.

<Steps>
  <Step>
    ## Revisar las recomendaciones

    Antes de instalar ClickHouse, consulte las siguientes recomendaciones:

    * **Swap:** Desactive el archivo de intercambio del sistema operativo en entornos de producción.
    * **Espacio en disco:** El ejecutable de ClickHouse requiere al menos 2,5 GB de espacio en disco para su instalación.
    * **Red:** Para despliegues distribuidos (clustering), use al menos una conectividad de red de 10 Gbit. El ancho de banda de la red es fundamental para procesar consultas distribuidas con grandes volúmenes de datos intermedios, así como para la replicación.

    **Estimación de los requisitos de almacenamiento**

    Para estimar el espacio en disco necesario para sus datos:

    1. **Estime el volumen de datos:** Tome una muestra de sus datos y calcule el tamaño medio de cada fila; luego, multiplíquelo por el número de filas que prevé almacenar.
    2. **Aplique el coeficiente de compresión:** Cargue una muestra en ClickHouse y compare el tamaño de los datos originales con el tamaño de la tabla almacenada. Los datos de clickstream, por ejemplo, suelen comprimirse entre 6 y 10 veces.
    3. **Tenga en cuenta las réplicas:** Si prevé almacenar datos en varias réplicas, multiplique el volumen estimado por el número de réplicas.

    Para consultar requisitos de hardware más detallados, vea ["Dimensionamiento y recomendaciones de hardware"](/es/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## Configurar el repositorio de Debian

    Para instalar ClickHouse, ejecute los siguientes comandos:

    ```bash theme={null}
    # Instalar los paquetes necesarios
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # Descargar la clave GPG de ClickHouse y almacenarla en el llavero
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # Obtener la arquitectura del sistema
    ARCH=$(dpkg --print-architecture)

    # Añadir el repositorio de ClickHouse a las fuentes de apt
    echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list

    # Actualizar las listas de paquetes de apt
    sudo apt-get update
    ```

    * Puede sustituir `stable` por `lts` para usar distintos [tipos de versión](/es/resources/support-center/knowledge-base/setup-installation/production) según sus necesidades.
    * Puede descargar e instalar los paquetes manualmente desde [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/).

    <br />

    <Accordion title="Método para distribuciones antiguas para instalar los paquetes deb">
      ```bash theme={null}
      # Instalar los paquetes necesarios
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # Añadir la clave GPG de ClickHouse para autenticar los paquetes
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # Añadir el repositorio de ClickHouse a las fuentes de apt
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # Actualizar las listas de paquetes de apt
      sudo apt-get update

      # Instalar los paquetes de ClickHouse server y clickhouse client
      sudo apt-get install -y clickhouse-server clickhouse-client

      # Iniciar el servicio de ClickHouse server
      sudo service clickhouse-server start

      # Iniciar el cliente de línea de comandos de ClickHouse
      clickhouse-client # o "clickhouse-client --password" si configuró una contraseña.
      ```
    </Accordion>
  </Step>

  <Step>
    ## Instalar ClickHouse server y clickhouse client

    ```bash theme={null}
    sudo apt-get install -y clickhouse-server clickhouse-client
    ```
  </Step>

  <Step>
    ## Iniciar ClickHouse

    Para iniciar ClickHouse server, ejecute:

    ```bash theme={null}
    sudo service clickhouse-server start
    ```

    Para iniciar clickhouse client, ejecute:

    ```bash theme={null}
    clickhouse-client
    ```

    Si configuró una contraseña para el servidor, deberá ejecutar:

    ```bash theme={null}
    clickhouse-client --password
    ```
  </Step>

  <Step>
    ## Instalar standalone ClickHouse Keeper

    <Tip>
      En entornos de producción, recomendamos encarecidamente ejecutar ClickHouse Keeper en nodos dedicados.
      En entornos de prueba, si decide ejecutar ClickHouse Server y ClickHouse Keeper en el mismo servidor,
      no necesita instalar ClickHouse Keeper, ya que se incluye con ClickHouse server.
    </Tip>

    Para instalar `clickhouse-keeper` en servidores standalone ClickHouse Keeper, ejecute:

    ```bash theme={null}
    sudo apt-get install -y clickhouse-keeper
    ```
  </Step>

  <Step>
    ## Habilitar e iniciar ClickHouse Keeper

    ```bash theme={null}
    sudo systemctl enable clickhouse-keeper
    sudo systemctl start clickhouse-keeper
    sudo systemctl status clickhouse-keeper
    ```
  </Step>
</Steps>

<div id="packages">
  ## Paquetes
</div>

A continuación se detallan los distintos paquetes deb disponibles:

| Package                        | Description                                                                                                                                                                                                                                                                                         |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | Instala los binarios compilados de ClickHouse.                                                                                                                                                                                                                                                      |
| `clickhouse-server`            | Crea un enlace simbólico para `clickhouse-server` e instala la configuración predeterminada del servidor.                                                                                                                                                                                           |
| `clickhouse-client`            | Crea un enlace simbólico para `clickhouse-client` y otras herramientas relacionadas con el cliente, e instala los archivos de configuración del cliente.                                                                                                                                            |
| `clickhouse-common-static-dbg` | Instala los binarios compilados de ClickHouse con información de depuración.                                                                                                                                                                                                                        |
| `clickhouse-keeper`            | Se utiliza para instalar ClickHouse Keeper en nodos dedicados de ClickHouse Keeper. Si ejecuta ClickHouse Keeper en el mismo servidor que ClickHouse server, no es necesario instalar este paquete. Instala ClickHouse Keeper y los archivos de configuración predeterminados de ClickHouse Keeper. |

<br />

<Info>
  Si necesita instalar una versión específica de ClickHouse, debe instalar todos los paquetes con la misma versión:
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>