Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Instalar ClickHouse en Debian/Ubuntu

Se recomienda usar paquetes deb oficiales precompilados para Debian o Ubuntu.

Revisar las recomendaciones

Antes de instalar ClickHouse, consulte las siguientes recomendaciones:

  • Swap: Desactive el archivo de intercambio del sistema operativo en entornos de producción.
  • Espacio en disco: El ejecutable de ClickHouse requiere al menos 2,5 GB de espacio en disco para su instalación.
  • Red: Para despliegues distribuidos (clustering), use al menos una conectividad de red de 10 Gbit. El ancho de banda de la red es fundamental para procesar consultas distribuidas con grandes volúmenes de datos intermedios, así como para la replicación.

Estimación de los requisitos de almacenamiento

Para estimar el espacio en disco necesario para sus datos:

  1. Estime el volumen de datos: Tome una muestra de sus datos y calcule el tamaño medio de cada fila; luego, multiplíquelo por el número de filas que prevé almacenar.
  2. Aplique el coeficiente de compresión: Cargue una muestra en ClickHouse y compare el tamaño de los datos originales con el tamaño de la tabla almacenada. Los datos de clickstream, por ejemplo, suelen comprimirse entre 6 y 10 veces.
  3. Tenga en cuenta las réplicas: Si prevé almacenar datos en varias réplicas, multiplique el volumen estimado por el número de réplicas.

Para consultar requisitos de hardware más detallados, vea "Dimensionamiento y recomendaciones de hardware"

Configurar el repositorio de Debian

Para instalar ClickHouse, ejecute los siguientes comandos:

# Instalar los paquetes previos necesarios
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# Descargar la clave GPG de ClickHouse y almacenarla en el keyring
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# Obtener la arquitectura del sistema
ARCH=$(dpkg --print-architecture)

# Añadir el repositorio de ClickHouse a las fuentes de 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

# Actualizar las listas de paquetes de apt
sudo apt-get update

Método para instalar paquetes deb en distribuciones antiguas
# Instalar los paquetes previos necesarios
sudo apt-get install apt-transport-https ca-certificates dirmngr

# Añadir la clave GPG de ClickHouse para autenticar los paquetes
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

# Añadir el repositorio de ClickHouse a las fuentes de apt
echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
    /etc/apt/sources.list.d/clickhouse.list
    
# Actualizar las listas de paquetes de apt
sudo apt-get update

# Instalar los paquetes de ClickHouse server y Client
sudo apt-get install -y clickhouse-server clickhouse-client

# Iniciar el servicio de ClickHouse server
sudo service clickhouse-server start

# Iniciar el Client de línea de comandos de ClickHouse
clickhouse-client # o "clickhouse-client --password" si configuró una contraseña.

Instalar ClickHouse server y Client

sudo apt-get install -y clickhouse-server clickhouse-client

Iniciar ClickHouse

Para iniciar ClickHouse server, ejecute:

sudo service clickhouse-server start

Para iniciar ClickHouse Client, ejecute:

clickhouse-client

Si configuró una contraseña para su servidor, deberá ejecutar:

clickhouse-client --password

Instalar standalone ClickHouse Keeper

Para instalar clickhouse-keeper en servidores standalone ClickHouse Keeper, ejecute:

sudo apt-get install -y clickhouse-keeper

Habilitar e iniciar ClickHouse Keeper

sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper

Paquetes

A continuación se detallan los distintos paquetes deb disponibles:

Package Description
clickhouse-common-static Instala archivos binarios compilados de ClickHouse.
clickhouse-server Crea un enlace simbólico para clickhouse-server e instala la configuración predeterminada del servidor.
clickhouse-client Crea un enlace simbólico para clickhouse-client y otras herramientas relacionadas, e instala los archivos de configuración del Client.
clickhouse-common-static-dbg Instala archivos binarios compilados de ClickHouse con información de depuración.
clickhouse-keeper Se utiliza para instalar ClickHouse Keeper en nodos dedicados de ClickHouse Keeper. Si ejecuta ClickHouse Keeper en el mismo servidor que ClickHouse server, no necesita instalar este paquete. Instala ClickHouse Keeper y los archivos de configuración predeterminados de ClickHouse Keeper.

Navigation