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

> Instale o ClickHouse no NixOS e com o Nix

# Instalar o ClickHouse no NixOS

<div id="install-from-nix">
  # Instale o ClickHouse no NixOS
</div>

> O ClickHouse está disponível no repositório Nixpkgs e pode ser instalado com o Nix no **Linux** e no **macOS**.

<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>
    ## Instale o ClickHouse com o Nix

    Você pode usar o Nix para instalar o ClickHouse sem adicioná-lo permanentemente ao sistema:

    ```bash theme={null}
    # Instale a versão estável mais recente
    nix shell nixpkgs#clickhouse

    # Ou instale a versão LTS
    nix shell nixpkgs#clickhouse-lts
    ```

    Isso disponibilizará o binário `clickhouse` na sessão atual do shell.

    * O pacote `nixpkgs#clickhouse` fornece a versão estável mais recente.
    * O pacote `nixpkgs#clickhouse-lts` fornece a versão com suporte de longo prazo.
    * Ambos os pacotes funcionam no Linux e no macOS.
  </Step>

  <Step>
    ## Instalação permanente

    Para instalar o ClickHouse permanentemente no sistema:

    **Para usuários do NixOS**, adicione isto ao `configuration.nix`:

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

    Em seguida, reconstrua o sistema:

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

    **Para usuários que não usam NixOS**, instale com o perfil do Nix:

    ```bash theme={null}
    # Instale a versão estável mais recente
    nix profile install nixpkgs#clickhouse

    # Ou instale a versão LTS
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

  <Step>
    ## Inicie o servidor ClickHouse

    Após a instalação, você pode iniciar o servidor ClickHouse:

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

    Por padrão, o servidor será iniciado com uma configuração básica e ficará escutando em `localhost:9000`.

    Para uso em produção no NixOS, talvez seja interessante configurar o ClickHouse como um serviço do sistema. Consulte o [manual do NixOS](https://search.nixos.org/options?query=clickhouse) para ver as opções de configuração disponíveis.
  </Step>

  <Step>
    ## Inicie o cliente ClickHouse

    Para se conectar ao servidor ClickHouse, abra um novo terminal e execute:

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

<div id="about-nix-package">
  ## Sobre o pacote Nix
</div>

O pacote ClickHouse no Nixpkgs inclui:

* `clickhouse-server` - O servidor de banco de dados do ClickHouse
* `clickhouse-client` - O cliente de linha de comando para se conectar ao ClickHouse
* `clickhouse-local` - Uma ferramenta para executar consultas SQL em arquivos locais
* Outros utilitários do ClickHouse

Para mais informações sobre o pacote ClickHouse no Nixpkgs, acesse:

* [Pacote ClickHouse no Nixpkgs](https://search.nixos.org/packages?query=clickhouse)
* [Opções do serviço ClickHouse no NixOS](https://search.nixos.org/options?query=clickhouse)