Pular para o conteúdo principal
Se você não precisa instalar o ClickHouse em produção, pode executar um script de instalação com curl. O script identificará um binário adequado para o seu sistema operacional.
1

Instale o ClickHouse usando curl

Execute o comando abaixo para baixar um único binário para o seu sistema operacional.
curl https://clickhouse.com/ | sh
No Linux e no macOS, isso também instala o clickhousectl em ~/.local/bin (com um link simbólico chctl) para que você possa gerenciar versões locais e servidores do ClickHouse.Para instalar apenas o binário clickhouse, sem o clickhousectl, defina CLICKHOUSE_ONLY=1:
curl https://clickhouse.com/ | CLICKHOUSE_ONLY=1 sh
Para usuários de Mac: se você estiver recebendo erros informando que o desenvolvedor do binário não pode ser verificado, consulte este artigo.
2

Inicie o clickhouse-local

O clickhouse-local permite processar arquivos locais e remotos usando a poderosa sintaxe SQL do ClickHouse, sem necessidade de configuração. Os dados da tabela são armazenados em um local temporário, o que significa que, após reiniciar o clickhouse-local, as tabelas criadas anteriormente não estarão mais disponíveis.Execute o comando abaixo para iniciar o clickhouse-local:
./clickhouse
3

Inicie o clickhouse-server

Se quiser persistir os dados, execute o clickhouse-server. Você pode iniciar o servidor ClickHouse com o seguinte comando:
./clickhouse server
4

Inicie o clickhouse-client

Com o servidor em execução, abra uma nova janela do terminal e execute o comando abaixo para iniciar o clickhouse-client:
./clickhouse client
Você verá algo como isto:
./clickhouse client
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)
Os dados da tabela são armazenados no diretório atual e continuarão disponíveis após reiniciar o servidor ClickHouse. Se necessário, você pode passar -C config.xml como argumento adicional de linha de comando para ./clickhouse server e fornecer configurações adicionais em um arquivo de configuração. Todas as configurações disponíveis estão documentadas aqui e no modelo de arquivo de configuração de exemplo.Agora você já pode começar a enviar comandos SQL ao ClickHouse!
O Quick Start orienta você nas etapas de criação de tabelas e inserção de dados.
Última modificação em 29 de junho de 2026