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

> Установка ClickHouse на NixOS и с помощью Nix

# Установка ClickHouse на NixOS

<div id="install-from-nix">
  # Установка ClickHouse на NixOS
</div>

> ClickHouse доступен в репозитории Nixpkgs и может быть установлен с помощью Nix в **Linux** и **macOS**.

<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>
    ## Установите ClickHouse с помощью Nix

    Вы можете использовать Nix, чтобы установить ClickHouse без постоянного добавления в систему:

    ```bash theme={null}
    # Установить последнюю стабильную версию
    nix shell nixpkgs#clickhouse

    # Или установить LTS-версию
    nix shell nixpkgs#clickhouse-lts
    ```

    Это сделает бинарный файл `clickhouse` доступным в текущем сеансе оболочки.

    * Пакет `nixpkgs#clickhouse` предоставляет последнюю стабильную версию.
    * Пакет `nixpkgs#clickhouse-lts` предоставляет LTS-версию.
    * Оба пакета работают в Linux и macOS.
  </Step>

  <Step>
    ## Постоянная установка

    Чтобы установить ClickHouse в систему на постоянной основе:

    **Для пользователей NixOS** добавьте в `configuration.nix`:

    ```nix theme={null}
    environment.systemPackages = with pkgs; [
      clickhouse
    ];
    ```

    Затем пересоберите систему:

    ```bash theme={null}
    sudo nixos-rebuild switch
    ```

    **Для пользователей не NixOS** выполните установку с помощью профиля Nix:

    ```bash theme={null}
    # Установить последнюю стабильную версию
    nix profile install nixpkgs#clickhouse

    # Или установить LTS-версию
    nix profile install nixpkgs#clickhouse-lts
    ```
  </Step>

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

    После установки вы можете запустить сервер ClickHouse:

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

    По умолчанию сервер запустится с базовой конфигурацией и будет прослушивать `localhost:9000`.

    Для использования в production-среде на NixOS вы можете настроить ClickHouse как системный сервис. Доступные параметры конфигурации см. в [руководстве NixOS](https://search.nixos.org/options?query=clickhouse).
  </Step>

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

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

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

<div id="about-nix-package">
  ## О пакете ClickHouse в Nix
</div>

Пакет ClickHouse в Nixpkgs включает:

* `clickhouse-server` — сервер базы данных ClickHouse
* `clickhouse-client` — клиент командной строки для подключения к ClickHouse
* `clickhouse-local` — инструмент для выполнения SQL-запросов к локальным файлам
* другие утилиты ClickHouse

Дополнительные сведения о пакете ClickHouse в Nixpkgs см. здесь:

* [Пакет ClickHouse в Nixpkgs](https://search.nixos.org/packages?query=clickhouse)
* [Параметры сервиса ClickHouse в NixOS](https://search.nixos.org/options?query=clickhouse)