> ## 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 o ClickHouse no MacOS

# Instalar o ClickHouse usando arquivos tgz

<div id="install-clickhouse-using-tgz-archives">
  # Instale o ClickHouse usando arquivos tgz
</div>

> Recomenda-se usar arquivos `tgz` oficiais pré-compilados para todas as distribuições Linux em que não seja possível instalar pacotes `deb` ou `rpm`.

<Steps>
  <Step>
    ## Revise as recomendações

    Antes de instalar o ClickHouse, revise as seguintes recomendações:

    * **Swap:** Desative o arquivo de swap do sistema operacional em ambientes de produção.
    * **Disk space:** O binário do ClickHouse requer pelo menos 2,5 GB de espaço em disco para ser instalado.
    * **Network:** Para implantações distribuídas (clustering), use conectividade de rede de pelo menos 10 Gbit. A largura de banda da rede é fundamental para processar consultas distribuídas com grandes volumes de dados intermediários, bem como para a replicação.

    **Estimativa dos requisitos de armazenamento**

    Para estimar o espaço em disco necessário para seus dados:

    1. **Estimate data volume:** Pegue uma amostra dos seus dados e calcule o tamanho médio da linha; em seguida, multiplique pelo número de linhas que você pretende armazenar.
    2. **Apply the compression coefficient:** Carregue uma amostra no ClickHouse e compare o tamanho dos dados originais com o tamanho da tabela armazenada. Dados de clickstream, por exemplo, normalmente são comprimidos entre 6x e 10x.
    3. **Account for replicas:** Se você pretende armazenar dados em várias réplicas, multiplique o volume estimado pelo número de réplicas.

    Para ver requisitos de hardware mais detalhados, consulte ["Dimensionamento e recomendações de hardware"](/pt-BR/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## Baixe e instale a versão estável mais recente

    A versão necessária pode ser baixada com `curl` ou `wget` do repositório [https://packages.clickhouse.com/tgz/](https://packages.clickhouse.com/tgz/).
    Depois disso, os arquivos baixados devem ser extraídos e instalados com os scripts de instalação.

    Abaixo está um exemplo de como instalar a versão estável mais recente.

    <Note>
      Para ambientes de produção, recomenda-se usar a versão `stable` mais recente.
      Você pode encontrar o número do lançamento nesta [página do GitHub](https://github.com/ClickHouse/ClickHouse/tags)
      com o sufixo `-stable`.
    </Note>
  </Step>

  <Step>
    ## Obtenha a versão mais recente do ClickHouse

    Obtenha a versão mais recente do ClickHouse no GitHub e armazene-a na variável `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>
    ## Detecte a arquitetura do seu sistema

    Detecte a arquitetura do sistema e defina a variável ARCH de acordo:

    ```bash theme={null}
    case $(uname -m) in
      x86_64) ARCH=amd64 ;;         # Para processadores Intel/AMD de 64 bits
      aarch64) ARCH=arm64 ;;        # Para processadores ARM de 64 bits
      *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Encerra se a arquitetura não for compatível
    esac
    ```
  </Step>

  <Step>
    ## Baixe os tarballs de cada componente do ClickHouse

    Baixe os tarballs de cada componente do ClickHouse. O loop tenta primeiro os
    pacotes específicos da arquitetura e, depois, recorre aos 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>
    ## Extraia e instale os pacotes

    Execute os comandos abaixo para extrair e instalar os seguintes pacotes:

    * `clickhouse-common-static`

    ```bash theme={null}
    # Extrai e instala o pacote 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}
    # Extrai e instala o pacote de símbolos de depuração
    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}
    # Extrai e instala o pacote do servidor com configuração
    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  # Inicia o servidor
    ```

    * `clickhouse-client`

    ```bash theme={null}
    # Extrai e instala o pacote do 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>