> ## 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 на macOS

# Установка ClickHouse из архивов tgz

> Для всех дистрибутивов Linux, где невозможно установить пакеты `deb` или `rpm`, рекомендуется использовать официальные предварительно скомпилированные архивы `tgz`.

<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>
    ## Скачайте и установите последнюю стабильную версию

    Нужную версию можно скачать с помощью `curl` или `wget` из репозитория [https://packages.clickhouse.com/tgz/](https://packages.clickhouse.com/tgz/).
    После этого скачанные архивы нужно распаковать и установить с помощью установочных скриптов.

    Ниже приведен пример установки последней стабильной версии.

    <Note>
      Для окружений продакшн рекомендуется использовать последнюю `stable`-версию.
      Номер версии можно найти на этой [странице GitHub](https://github.com/ClickHouse/ClickHouse/tags)
      с постфиксом `-stable`.
    </Note>
  </Step>

  <Step>
    ## Получите последнюю версию ClickHouse

    Получите последнюю версию ClickHouse из GitHub и сохраните ее в переменной `LATEST_VERSION`.

    ```bash theme={null}
    LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
        grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
    export LATEST_VERSION
    ```
  </Step>

  <Step>
    ## Определите архитектуру вашей системы

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

    ```bash theme={null}
    case $(uname -m) in
      x86_64) ARCH=amd64 ;;         # Для 64-битных процессоров Intel/AMD
      aarch64) ARCH=arm64 ;;        # Для 64-битных процессоров ARM
      *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # Выход, если архитектура не поддерживается
    esac
    ```
  </Step>

  <Step>
    ## Скачайте tar-архивы для каждого компонента ClickHouse

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

    ```bash theme={null}
    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-$LATEST_VERSION-${ARCH}.tgz" \
        || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
    done
    ```
  </Step>

  <Step>
    ## Распакуйте и установите пакеты

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

    * `clickhouse-common-static`

    ```bash theme={null}
    # Распаковка и установка пакета clickhouse-common-static
    tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
    sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
    ```

    * `clickhouse-common-static-dbg`

    ```bash theme={null}
    # Распаковка и установка пакета с символами отладки
    tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
    sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
    ```

    * `clickhouse-server`

    ```bash theme={null}
    # Распаковка и установка серверного пакета с конфигурацией
    tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
    sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
    sudo /etc/init.d/clickhouse-server start  # Запуск сервера
    ```

    * `clickhouse-client`

    ```bash theme={null}
    # Распаковка и установка клиентского пакета
    tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
      || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
    sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
    ```
  </Step>
</Steps>