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

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

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

> 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` предоставляет версию с долгосрочной поддержкой.
    * Оба пакета работают на 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`.

    Для использования в продакшн на 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)