> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Установите ClickHouse в Debian/Ubuntu Linux

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

<div id="install-from-deb-packages">
  # Установка ClickHouse на Debian/Ubuntu
</div>

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

<Steps>
  <Step>
    ## Ознакомьтесь с рекомендациями

    Перед установкой ClickHouse ознакомьтесь со следующими рекомендациями:

    * **Swap:** В рабочей среде отключите файл подкачки операционной системы.
    * **Disk space:** Для установки бинарного файла ClickHouse требуется не менее 2,5 ГБ дискового пространства.
    * **Network:** Для распределённых развертываний (кластеризации) используйте сетевое подключение со скоростью не менее 10 Гбит/с. Пропускная способность сети критически важна для выполнения распределённых запросов с большими объёмами промежуточных данных, а также для репликации.

    **Оценка требований к хранилищу**

    Чтобы оценить, сколько дискового пространства потребуется для ваших данных:

    1. **Оцените объём данных:** Возьмите выборку данных и вычислите средний размер строки, затем умножьте его на количество строк, которое вы планируете хранить.
    2. **Примените коэффициент сжатия:** Загрузите выборку в ClickHouse и сравните исходный размер данных с размером сохранённой таблицы. Например, clickstream-данные обычно сжимаются в 6–10 раз.
    3. **Учтите реплики:** Если вы планируете хранить данные в нескольких репликах, умножьте расчётный объём на количество реплик.

    Более подробные требования к оборудованию см. в разделе ["Рекомендации по выбору размера и оборудования"](/ru/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## Настройте репозиторий Debian

    Чтобы установить ClickHouse, выполните следующие команды:

    ```bash theme={null}
    # Установите необходимые пакеты
    sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

    # Загрузите GPG-ключ ClickHouse и сохраните его в хранилище ключей
    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 в источники 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

    # Обновите списки пакетов apt
    sudo apt-get update
    ```

    * Вы можете заменить `stable` на `lts`, чтобы использовать другой [тип релиза](/ru/resources/support-center/knowledge-base/setup-installation/production) в зависимости от ваших потребностей.
    * Вы можете вручную скачать и установить пакеты с [packages.clickhouse.com](https://packages.clickhouse.com/deb/pool/main/c/).

    <br />

    <Accordion title="Старый способ установки deb-пакетов для устаревших дистрибутивов">
      ```bash theme={null}
      # Установите необходимые пакеты
      sudo apt-get install apt-transport-https ca-certificates dirmngr

      # Добавьте GPG-ключ ClickHouse для проверки подлинности пакетов
      sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754

      # Добавьте репозиторий ClickHouse в источники apt
      echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
          /etc/apt/sources.list.d/clickhouse.list
          
      # Обновите списки пакетов apt
      sudo apt-get update

      # Установите пакеты сервера и клиента ClickHouse
      sudo apt-get install -y clickhouse-server clickhouse-client

      # Запустите сервер ClickHouse
      sudo service clickhouse-server start

      # Запустите клиент командной строки ClickHouse
      clickhouse-client # или "clickhouse-client --password", если вы настроили пароль.
      ```
    </Accordion>
  </Step>

  <Step>
    ## Установите сервер и клиент ClickHouse

    ```bash theme={null}
    sudo apt-get install -y clickhouse-server clickhouse-client
    ```
  </Step>

  <Step>
    ## Запустите ClickHouse

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

    ```bash theme={null}
    sudo service clickhouse-server start
    ```

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

    ```bash theme={null}
    clickhouse-client
    ```

    Если вы настроили пароль для сервера, выполните:

    ```bash theme={null}
    clickhouse-client --password
    ```
  </Step>

  <Step>
    ## Установите автономный ClickHouse Keeper

    <Tip>
      В производственных средах мы настоятельно рекомендуем запускать ClickHouse Keeper на выделенных узлах.
      В тестовых средах, если вы решили запускать сервер ClickHouse и ClickHouse Keeper на одном сервере,
      то устанавливать ClickHouse Keeper не нужно, так как он входит в состав сервера ClickHouse.
    </Tip>

    Чтобы установить `clickhouse-keeper` на серверах с автономным ClickHouse Keeper, выполните:

    ```bash theme={null}
    sudo apt-get install -y clickhouse-keeper
    ```
  </Step>

  <Step>
    ## Включите и запустите ClickHouse Keeper

    ```bash theme={null}
    sudo systemctl enable clickhouse-keeper
    sudo systemctl start clickhouse-keeper
    sudo systemctl status clickhouse-keeper
    ```
  </Step>
</Steps>

<div id="packages">
  ## Пакеты
</div>

Ниже приведено описание доступных deb-пакетов:

| Package                        | Description                                                                                                                                                                                                                                                                               |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clickhouse-common-static`     | Устанавливает скомпилированные бинарные файлы ClickHouse.                                                                                                                                                                                                                                 |
| `clickhouse-server`            | Создает символическую ссылку на `clickhouse-server` и устанавливает конфигурацию сервера по умолчанию.                                                                                                                                                                                    |
| `clickhouse-client`            | Создает символическую ссылку на `clickhouse-client` и другие клиентские инструменты, а также устанавливает файлы конфигурации клиента.                                                                                                                                                    |
| `clickhouse-common-static-dbg` | Устанавливает скомпилированные бинарные файлы ClickHouse с отладочной информацией.                                                                                                                                                                                                        |
| `clickhouse-keeper`            | Используется для установки ClickHouse Keeper на выделенные узлы ClickHouse Keeper. Если ClickHouse Keeper запущен на том же сервере, что и ClickHouse server, устанавливать этот пакет не требуется. Устанавливает ClickHouse Keeper и файлы конфигурации ClickHouse Keeper по умолчанию. |

<br />

<Info>
  Если вам нужно установить определенную версию ClickHouse, необходимо установить все пакеты одной и той же версии:
  `sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7`
</Info>