Перейти к основному содержимому
Версия: 5.2

Установка ClickHouse

Аппаратные и программные требования​

Технические характеристики оборудования описаны в разделе аппаратные требования для установки ClickHouse. С перечнем программных требований можно ознакомиться в соответствующем разделе программные требования.

Политика выбора версии

Для установки используется переменная окружения VERSION или явное указание номера версии в имени/параметре пакета.

Обзор вариантов установки​

Официальная документация ClickHouse рекомендует следующие способы установки:

  • через пакеты deb для Debian/Ubuntu
  • через rpm‑репозиторий для RedHat‑подобных систем
  • из tgz‑архивов для дистрибутивов Linux

Ниже приведены адаптированные инструкции для:

  • Debian / Ubuntu
  • RedHat / CentOS и других rpm‑дистрибутивов
  • дистрибутивы Linux (установка из tgz‑архивов)

Во всех случаях отдельно описано, как посмотреть доступные версии и выбрать нужную.

Установка на Debian / Ubuntu из официального репозитория​

Подключение репозитория ClickHouse​

# Предварительные пакеты
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# Загрузка GPG‑ключа ClickHouse и сохранение в keyring
curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' |   sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg

# Определение архитектуры системы
ARCH=$(dpkg --print-architecture)

# Подключение репозитория ClickHouse (stable-ветка)
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

# Обновление списка пакетов
sudo apt-get update
Обратите внимание!

При необходимости можно заменить stable на lts, чтобы использовать линейку LTS‑релизов. Актуальный список релизов и их тип (LTS, fast и т. д.) доступен в changelog ClickHouse.

Просмотр доступных версий ClickHouse (Debian / Ubuntu)​

После подключения репозитория можно вывести список доступных версий пакета с помощью следующих команд:

apt-cache madison clickhouse-server

или:

apt-cache policy clickhouse-server

В выводе будет несколько строк с версиями; выберите нужную версию (например 25.7.4.11 или более новую LTS/Stable).

Единство версий

Для корректной работы рекомендуется устанавливать все основные пакеты одной и той же версии: clickhouse-common-static, clickhouse-server, clickhouse-client. При установке конкретной версии нужно указать ее для всех этих пакетов.

Установка конкретной версии ClickHouse (Debian / Ubuntu)​

После того как версия выбрана, зафиксируйте ее в переменной VERSION:

Пример
export VERSION=25.7.4.11

Установите пакеты данной версии с помощью следующей команды:

sudo apt-get install -y   clickhouse-common-static=${VERSION}   clickhouse-server=${VERSION}   clickhouse-client=${VERSION}

Альтернативно можно указать версию непосредственно в команде без переменной:

sudo apt-get install   clickhouse-server=25.7.4.11   clickhouse-client=25.7.4.11   clickhouse-common-static=25.7.4.11

Запуск сервера и клиента ClickHouse (Debian / Ubuntu)​

Запуск сервера
sudo service clickhouse-server start
Подключение
# Подключиться через клиент:
clickhouse-client
# или, если настроен пароль:
clickhouse-client --password

Установка и запуск ClickHouse Keeper на выделенных узлах (опционально)​

После подготовки конфигурационного файла Keeper на каждом выделенном узле выполните следующие команды по порядку:

sudo apt-get install -y clickhouse-keeper

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

Установка на RedHat / CentOS и другие rpm‑дистрибутивы​

Подключение RPM‑репозитория ClickHouse​

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

Для систем с zypper (openSUSE, SLES) используются следующие команды:

sudo zypper addrepo -r https://packages.clickhouse.com/rpm/clickhouse.repo -g
sudo zypper --gpg-auto-import-keys refresh clickhouse-stable

Просмотр доступных версий ClickHouse (RedHat / CentOS)​

После подключения репозитория можно вывести все доступные версии пакета:

sudo yum list clickhouse-server --showduplicates

или, при необходимости, отфильтровать и отсортировать вывод:

sudo yum list clickhouse-server --showduplicates | sort -r

Выберите нужную версию, например 25.7.4.11 или актуальный LTS‑релиз. Поддерживается установка конкретной версии через добавление номера версии к имени пакета.

Установка конкретной версии ClickHouse (RedHat / CentOS)​

Зафиксируйте выбранную версию:

Пример
export VERSION=25.7.4.11

Установите server и client данной версии с помощью следующей команды:

sudo yum install -y   clickhouse-server-${VERSION}   clickhouse-client-${VERSION}

При необходимости можно добавить clickhouse-common-static-${VERSION} и другие пакеты (например, clickhouse-common-static-dbg).

Запуск ClickHouse (RedHat / CentOS)​

sudo systemctl enable clickhouse-server
sudo systemctl start clickhouse-server
sudo systemctl status clickhouse-server

clickhouse-client
# или при наличии пароля:
clickhouse-client --password

Установка ClickHouse Keeper (опционально)​

sudo yum install -y clickhouse-keeper
sudo systemctl enable clickhouse-keeper
sudo systemctl start clickhouse-keeper
sudo systemctl status clickhouse-keeper
Обратите внимание!

Для обеспечения отказоустойчивости и стабильности production‑кластеров, ClickHouse Keeper следует размещать на отдельных серверах, а не совместно с ClickHouse Server.

Установка из TGZ‑архивов (Other Linux)​

Данный метод рекомендуется для дистрибутивов без полноценной поддержки пакетов deb/rpm, а также в случаях, когда необходим полный контроль над структурой каталогов и процессом установки.

Просмотр доступных версий ClickHouse (tgz)​

Доступные tgz‑архивы публикуются в репозитории:

  • https://packages.clickhouse.com/tgz/stable/ — стабильные релизы
  • https://packages.clickhouse.com/tgz/lts/ — LTS‑релизы

Для просмотра списка версий используйте браузер или командную строку. Например, чтобы получить перечень версий из служебного файла version_date.tsv:

curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv |   awk -F'	' '{print $1}' | sort -Vr | head

Команда выведет несколько последних версий. Выберите ту, которая утверждена для использования в вашем окружении (как правило, конкретный LTS‑ или stable‑релиз).

После выбора зафиксируйте версию в переменной:

Пример
export VERSION=25.7.4.11

Определение архитектуры целевой системы​

Определите архитектуру и зафиксируйте ее в переменной ARCH:

case $(uname -m) in
  x86_64) ARCH=amd64 ;;   # 64‑битные Intel/AMD
  aarch64) ARCH=arm64 ;;  # 64‑битные ARM
  *) echo "Unknown architecture $(uname -m)"; exit 1 ;;
esac

export ARCH

Загрузка архивов ClickHouse​

Загрузите tgz‑архивы для основных компонентов ClickHouse указанной версии. Алгоритм загрузки последовательно проверяет доступность:

  1. Архива для конкретной архитектуры
  2. Универсального архива (без указания архитектуры в имени)
for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
  curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$VERSION-${ARCH}.tgz"     || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$VERSION.tgz"
done

При необходимости можно заменить stable на lts, если используется линейка LTS‑релизов.

Установка на целевом хосте​

Далее выполняется распаковка и установка каждого компонента с помощью встроенных скриптов doinst.sh выбранной версии.

Установка clickhouse-common-static​

tar -xzvf "clickhouse-common-static-$VERSION-${ARCH}.tgz"   || tar -xzvf "clickhouse-common-static-$VERSION.tgz"
sudo "clickhouse-common-static-$VERSION/install/doinst.sh"

Установка clickhouse-common-static-dbg (опционально)​

tar -xzvf "clickhouse-common-static-dbg-$VERSION-${ARCH}.tgz"   || tar -xzvf "clickhouse-common-static-dbg-$VERSION.tgz"
sudo "clickhouse-common-static-dbg-$VERSION/install/doinst.sh"

Установка и запуск clickhouse-server​

tar -xzvf "clickhouse-server-$VERSION-${ARCH}.tgz"   || tar -xzvf "clickhouse-server-$VERSION.tgz"
sudo "clickhouse-server-$VERSION/install/doinst.sh" configure

# старт сервера
sudo /etc/init.d/clickhouse-server start

Установка clickhouse-client​

tar -xzvf "clickhouse-client-$VERSION-${ARCH}.tgz"   || tar -xzvf "clickhouse-client-$VERSION.tgz"
sudo "clickhouse-client-$VERSION/install/doinst.sh"

После установки подключитесь к серверу:

clickhouse-client
# или:
clickhouse-client --password

Пароль пользователя default и сетевой доступ​

Во время установки будет предложено задать пароль для встроенного пользователя default. Данный пароль сохраняется в файле /etc/clickhouse-server/users.d/default-password.xml. Его можно изменить в любое время путем редактирования этого конфигурационного файла.

По умолчанию ClickHouse может слушать только локальный интерфейс. Если необходимо принимать подключения с других серверов, проверьте параметры listen_host и связанные настройки в config.xml, а также правила файервола и сетевые ACL.