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

> Instalación de ClickHouse en NixOS y con Nix

# Instalar ClickHouse en NixOS

> ClickHouse está disponible en el repositorio de Nixpkgs y se puede instalar con Nix en **Linux** y **macOS**.

<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>
    ## Instalar ClickHouse con Nix

    Puedes usar Nix para instalar ClickHouse sin añadirlo de forma permanente a tu sistema:

    ```bash theme={null}
    # Instala la versión estable más reciente
    nix shell nixpkgs#clickhouse

    # O instala la versión LTS
    nix shell nixpkgs#clickhouse-lts
    ```

    Esto hará que el binario `clickhouse` esté disponible en tu sesión actual de shell.

    * El paquete `nixpkgs#clickhouse` proporciona la versión estable más reciente.
    * El paquete `nixpkgs#clickhouse-lts` proporciona la versión con soporte a largo plazo.
    * Ambos paquetes funcionan en Linux y macOS.
  </Step>

  <Step>
    ## Instalación permanente

    Para instalar ClickHouse de forma permanente en tu sistema:

    **Si usas NixOS**, añade esto a tu `configuration.nix`:

    ```nix theme={null}
    environment.systemPackages = with pkgs; [
      clickhouse
    ];
    ```

    Después, reconstruye tu sistema:

    ```bash theme={null}
    sudo nixos-rebuild switch
    ```

    **Si no usas NixOS**, instala con el perfil de Nix:

    ```bash theme={null}
    # Instala la versión estable más reciente
    nix profile install nixpkgs#clickhouse

    # O instala la versión LTS
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

  <Step>
    ## Iniciar el Client de ClickHouse

    Después de la instalación, puedes iniciar el servidor de ClickHouse:

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

    De forma predeterminada, el servidor se iniciará con una configuración básica y escuchará en `localhost:9000`.

    Para usarlo en producción en NixOS, puede que quieras configurar ClickHouse como un servicio del sistema. Consulta el [manual de NixOS](https://search.nixos.org/options?query=clickhouse) para ver las opciones de configuración disponibles.
  </Step>

  <Step>
    ## Iniciar el Client de ClickHouse

    Para conectarte al servidor de ClickHouse, abre una nueva terminal y ejecuta:

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

<div id="about-nix-package">
  ## Acerca del paquete de Nix
</div>

El paquete de ClickHouse en Nixpkgs incluye:

* `clickhouse-server` - El servidor de base de datos de ClickHouse
* `clickhouse-client` - El Client de línea de comandos para conectarse a ClickHouse
* `clickhouse-local` - Una herramienta para ejecutar consultas SQL en archivos locales
* Otras utilidades de ClickHouse

Para obtener más información sobre el paquete de ClickHouse en Nixpkgs, visita:

* [Paquete de ClickHouse en Nixpkgs](https://search.nixos.org/packages?query=clickhouse)
* [Opciones del servicio de ClickHouse en NixOS](https://search.nixos.org/options?query=clickhouse)