Установка ClickHouse

ClickHouse — это довольно популярная технология для выполнения OLAP аналитики. В этой опорной публикации зафиксирую, как выполняется установка ClickHouse.

Используемые версии ПО

Версия Linux — Rocky Linux release 9.7 (Blue Onyx).

Версия ClickHouse — 26.5.1.882.

Установка

Есть два основных сценария установки ClickHouse — установки в виде пакета для соответствующего дистрибутива и установка в видео Docker контейнера. Рассмотрим каждый из этих методов более детально.

Установка ClickHouse из пакета

Установка ClickHouse в виде пакета включает в себя следующие шаги:

1. Предварительная установка необходимых утилит:

sudo dnf install -y yum-utils mc

2. Добавление репозитория ClickHouse:

sudo yum-config-manager --add-repo https://packages.clickhouse.com/rpm/clickhouse.repo

3. Выполняем установку сервера и клиента:

sudo dnf install -y clickhouse-server clickhouse-client

4. Запускаем службу:

systemctl enable --now clickhouse-server

5. Проверяем статус службы:

systemctl status clickhouse-server

[root@ClickHouseTest admin]# systemctl status clickhouse-server
● clickhouse-server.service - ClickHouse Server (analytic DBMS for big data)
     Loaded: loaded (/usr/lib/systemd/system/clickhouse-server.service; enabled; preset: disabled)
     Active: active (running) since Thu 2026-06-11 15:56:34 UTC; 48s ago
   Main PID: 30047 (clickhouse-serv)
      Tasks: 680 (limit: 22812)
     Memory: 376.7M (peak: 417.7M)
        CPU: 7.062s
     CGroup: /system.slice/clickhouse-server.service
             ├─30041 clickhouse-watchdog "" "" "" "" "" "" "" --config=/etc/clickhouse-server/config.xml --pid-file=/run/cli>
             └─30047 /usr/bin/clickhouse-server --config=/etc/clickhouse-server/config.xml --pid-file=/run/clickhouse-server>

Jun 11 15:56:32 ClickHouseTest.plex.local systemd[1]: Starting ClickHouse Server (analytic DBMS for big data)...

6. По умолчанию ClickHouse прослушивает подключения только на localhost (127.0.0.1). Для того, что подключения прослушивались на всех адресах, нужно скорректировать конфигурационный файл сервера config.xml:

vi /etc/clickhouse-server/config.xml

В конфигурационном файле нужно найти вот такую строчку:

<!-- <listen_host>::</listen_host> -->

Раскомментируем эту строку:

<listen_host>::</listen_host>

7. Сохраняем внесенные изменения в файл config.xml и перезапускаем службу:

systemctl restart clickhouse-server

8. Проверяем прослушиваемые адреса:

ss -tulp

Теперь сервер ClickHouse прослушивает все доступные IP-адреса.

9. Осталось поменять пароль для пользователя «default». Откроем конфигурационный файл пользователей (users.xml).

vi /etc/clickhouse-server/users.xml

Найдите директиву <password>. Внутри директивы укажите пароль для пользователя default:

<password>Qwerty123</password>

10. Сохраняем внесенные изменения в файл config.xml и перезапускаем службу:

systemctl restart clickhouse-server

11. Проверяем прослушиваемые адреса:

Установка ClickHouse в Docker

Сначала нужно установить Docker:

sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io

Теперь запустим службу Docker:

sudo systemctl enable --now docker

Вот теперь можно запускать контейнер с ClickHouse:

docker run -d -p 18123:8123 -p19000:9000 -e CLICKHOUSE_PASSWORD=Qwerty123 --name clickhouse-server --ulimit nofile=262144:262144 clickhouse/clickhouse-server

Проверяем, что контейнер запущен:

docker ps | grep clickhouse-server

Тестирование подключения

Для работы с различными СУБД я использую Dbeaver.

В типе подключаемой СУБД выбираем «ClickHouse».

Указываем параметры подключения:

В случае успешного подключения мы должны увидеть состав объектов базы данных «default».

Подключение выполнено успешно.