Pular para o conteúdo principal

Instale o ClickHouse no NixOS

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

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 armazenamentoPara 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”
2

Instale o ClickHouse com o Nix

Você pode usar o Nix para instalar o ClickHouse sem adicioná-lo permanentemente ao sistema:
# 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.
3

Instalação permanente

Para instalar o ClickHouse permanentemente no sistema:Para usuários do NixOS, adicione isto ao configuration.nix:
environment.systemPackages = with pkgs; [
  clickhouse
];
Em seguida, reconstrua o sistema:
sudo nixos-rebuild switch
Para usuários que não usam NixOS, instale com o perfil do Nix:
# 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
4

Inicie o servidor ClickHouse

Após a instalação, você pode iniciar o servidor ClickHouse:
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 para ver as opções de configuração disponíveis.
5

Inicie o cliente ClickHouse

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

Sobre o pacote Nix

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:
Última modificação em 10 de junho de 2026