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

> Instalar ClickHouse en macOS

# Instalar ClickHouse mediante archivos tgz

<div id="install-clickhouse-using-tgz-archives">
  # Instalar ClickHouse usando archivos tgz
</div>

> Se recomienda usar archivos `tgz` oficiales precompilados para todas las distribuciones de Linux en las que no sea posible instalar paquetes `deb` o `rpm`.

<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>
    ## Descargar e instalar la última versión estable

    La versión requerida puede descargarse con `curl` o `wget` desde el repositorio [https://packages.clickhouse.com/tgz/](https://packages.clickhouse.com/tgz/).
    Después, los archivos descargados deben descomprimirse e instalarse mediante scripts de instalación.

    A continuación se muestra un ejemplo de cómo instalar la última versión estable.

    <Note>
      Para entornos de producción, se recomienda usar la versión `stable` más reciente.
      Puede encontrar el número de la versión en esta [página de GitHub](https://github.com/ClickHouse/ClickHouse/tags)
      con el sufijo `-stable`.
    </Note>
  </Step>

  <Step>
    ## Obtener la última versión de ClickHouse

    Obtenga la última versión de ClickHouse desde GitHub y guárdela en la variable `LATEST_VERSION`.

    ```bash theme={null}
    LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
        grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
    export LATEST_VERSION
    ```
  </Step>

  <Step>
    ## Detectar la arquitectura del sistema

    Detecte la arquitectura del sistema y establezca la variable ARCH según corresponda:

    ```bash theme={null}
    case $(uname -m) in
      x86_64) ARCH=amd64 ;;         # Para procesadores Intel/AMD de 64 bits
      aarch64) ARCH=arm64 ;;        # Para procesadores ARM de 64 bits
      *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Salir si la arquitectura no es compatible
    esac
    ```
  </Step>

  <Step>
    ## Descargar los archivos tar para cada componente de ClickHouse

    Descargue los archivos tar de cada componente de ClickHouse. El bucle prueba primero los
    paquetes específicos de la arquitectura y, si no están disponibles, recurre a los genéricos.

    ```bash theme={null}
    for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
    do
      curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
        || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
    done
    ```
  </Step>

  <Step>
    ## Extraer e instalar los paquetes

    Ejecute los siguientes comandos para extraer e instalar estos paquetes:

    * `clickhouse-common-static`

    ```bash theme={null}
    # Extraer e instalar el paquete clickhouse-common-static
    tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
    sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
    ```

    * `clickhouse-common-static-dbg`

    ```bash theme={null}
    # Extraer e instalar el paquete de símbolos de depuración
    tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
    sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
    ```

    * `clickhouse-server`

    ```bash theme={null}
    # Extraer e instalar el paquete del servidor con la configuración
    tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
    sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
    sudo /etc/init.d/clickhouse-server start  # Iniciar el servidor
    ```

    * `clickhouse-client`

    ```bash theme={null}
    # Extraer e instalar el paquete del cliente
    tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
    sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
    ```
  </Step>
</Steps>