Перейти к основному содержанию

Установка ClickHouse на Debian/Ubuntu

Рекомендуется использовать официальные готовые пакеты deb для Debian или Ubuntu.
1

Ознакомьтесь с рекомендациями

Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:
  • Swap: В рабочей среде отключите файл подкачки операционной системы.
  • Disk space: Для установки бинарного файла ClickHouse требуется не менее 2,5 ГБ дискового пространства.
  • Network: Для распределённых развертываний (кластеризации) используйте сетевое подключение со скоростью не менее 10 Гбит/с. Пропускная способность сети критически важна для выполнения распределённых запросов с большими объёмами промежуточных данных, а также для репликации.
Оценка требований к хранилищуЧтобы оценить, сколько дискового пространства потребуется для ваших данных:
  1. Оцените объём данных: Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
  2. Примените коэффициент сжатия: Загрузите выборку в ClickHouse и сравните исходный размер данных с размером сохранённой таблицы. Например, clickstream-данные обычно сжимаются в 6–10 раз.
  3. Учтите реплики: Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.
Более подробные требования к оборудованию см. в разделе “Рекомендации по выбору размера и оборудования”
2

Настройте репозиторий Debian

Чтобы установить ClickHouse, выполните следующие команды:
  • Вы можете заменить stable на lts, чтобы использовать другой тип релиза в зависимости от ваших потребностей.
  • Вы можете вручную скачать и установить пакеты с packages.clickhouse.com.

3

Установите сервер и клиент ClickHouse

4

Запустите ClickHouse

Чтобы запустить сервер ClickHouse, выполните:
Чтобы запустить клиент ClickHouse, выполните:
Если вы настроили пароль для сервера, выполните:
5

Установите автономный ClickHouse Keeper

В производственных средах мы настоятельно рекомендуем запускать ClickHouse Keeper на выделенных узлах. В тестовых средах, если вы решили запускать сервер ClickHouse и ClickHouse Keeper на одном сервере, то устанавливать ClickHouse Keeper не нужно, так как он входит в состав сервера ClickHouse.
Чтобы установить clickhouse-keeper на серверах с автономным ClickHouse Keeper, выполните:
6

Включите и запустите ClickHouse Keeper

Пакеты

Ниже приведено описание доступных deb-пакетов:
Если вам нужно установить определенную версию ClickHouse, необходимо установить все пакеты одной и той же версии: sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7
Последнее изменение 19 июня 2026 г.