> ## 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 o ClickHouse no Debian/Ubuntu Linux

# Instalar o ClickHouse no Debian/Ubuntu

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

> Recomenda-se usar os pacotes `deb` oficiais pré-compilados para **Debian** ou **Ubuntu**.

<Steps>
  <Step>
    ## Consulte 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>
    ## Configure o repositório do Debian

    Para instalar o ClickHouse, execute os seguintes comandos:

    ```bash theme={null}
    # Instale os pacotes de pré-requisito
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # Baixe a chave GPG do ClickHouse e armazene-a no keyring
    curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

    # Obtenha a arquitetura do sistema
    ARCH=$(dpkg --print-architecture)

    # Adicione o repositório do ClickHouse às fontes do 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

    # Atualize as listas de pacotes do apt
    sudo apt-get update
    ```

    * Você pode substituir `stable` por `lts` para usar diferentes [tipos de lançamento](/pt-BR/resources/support-center/knowledge-base/setup-installation/production), conforme a sua necessidade.
    * Você pode baixar e instalar os pacotes manualmente em [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/).

    <br />

    <Accordion title="Método para instalar pacotes deb em distribuições antigas">
      ```bash theme={null}
      # Instale os pacotes de pré-requisito
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # Adicione a chave GPG do ClickHouse para autenticar os pacotes
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # Adicione o repositório do ClickHouse às fontes do apt
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # Atualize as listas de pacotes do apt
      sudo apt-get update

      # Instale os pacotes do servidor e do cliente do ClickHouse
      sudo apt-get install -y clickhouse-server clickhouse-client

      # Inicie o serviço do servidor ClickHouse
      sudo service clickhouse-server start

      # Inicie o cliente de linha de comando do ClickHouse
      clickhouse-client # ou "clickhouse-client --password" se você tiver configurado uma senha.
      ```
    </Accordion>
  </Step>

  <Step>
    ## Instale o servidor e o cliente do ClickHouse

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

  <Step>
    ## Inicie o ClickHouse

    Para iniciar o servidor ClickHouse, execute:

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

    Para iniciar o cliente do ClickHouse, execute:

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

    Se você tiver configurado uma senha para o servidor, precisará executar:

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

  <Step>
    ## Instale o standalone ClickHouse Keeper

    <Tip>
      Em ambientes de produção, recomendamos fortemente executar o ClickHouse Keeper em nós dedicados.
      Em ambientes de teste, se você decidir executar o ClickHouse Server e o ClickHouse Keeper no mesmo servidor,
      não será necessário instalar o ClickHouse Keeper, pois ele já está incluído no servidor ClickHouse.
    </Tip>

    Para instalar o `clickhouse-keeper` em servidores standalone ClickHouse Keeper, execute:

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

  <Step>
    ## Habilite e inicie o 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">
  ## Pacotes
</div>

Os vários pacotes deb disponíveis estão detalhados abaixo:

| Pacote                         | Descrição                                                                                                                                                                                                                                                                                                   |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | Instala os arquivos binários compilados do ClickHouse.                                                                                                                                                                                                                                                      |
| `clickhouse-server`            | Cria um link simbólico para `clickhouse-server` e instala a configuração padrão do servidor.                                                                                                                                                                                                                |
| `clickhouse-client`            | Cria um link simbólico para `clickhouse-client` e outras ferramentas relacionadas ao cliente, além de instalar os arquivos de configuração do cliente.                                                                                                                                                      |
| `clickhouse-common-static-dbg` | Instala os arquivos binários compilados do ClickHouse com informações de depuração.                                                                                                                                                                                                                         |
| `clickhouse-keeper`            | Usado para instalar o ClickHouse Keeper em nós dedicados do ClickHouse Keeper. Se você estiver executando o ClickHouse Keeper no mesmo servidor que o servidor ClickHouse, não será necessário instalar este pacote. Instala o ClickHouse Keeper e os arquivos de configuração padrão do ClickHouse Keeper. |

<br />

<Info>
  Se você precisar instalar uma versão específica do ClickHouse, deverá instalar todos os pacotes na mesma versão:
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>