> ## 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 المضغوطة

> يُوصى باستخدام أرشيفات `tgz` الرسمية المجمّعة مسبقًا لجميع توزيعات Linux عندما لا يكون تثبيت حزم `deb` أو `rpm` ممكنًا.

<Steps>
  <Step>
    ## راجع التوصيات

    قبل تثبيت ClickHouse، راجع التوصيات التالية:

    * **Swap:** عطِّل ملف المبادلة الخاص بنظام التشغيل في بيئات الإنتاج.
    * **Disk space:** يتطلب الملف التنفيذي لـ ClickHouse ما لا يقل عن 2.5 جيجابايت من مساحة القرص لإتمام التثبيت.
    * **Network:** في عمليات النشر الموزعة (العنقدة)، استخدم اتصال شبكة بسرعة لا تقل عن 10 جيجابت. ويُعد عرض النطاق الترددي للشبكة عاملًا حاسمًا في معالجة الاستعلامات الموزعة التي تتضمن كميات كبيرة من البيانات الوسيطة، وكذلك في النسخ المتماثل.

    **تقدير متطلبات التخزين**

    لتقدير مساحة القرص المطلوبة لبياناتك:

    1. **Estimate data volume:** خذ عينة من بياناتك واحسب متوسط حجم الصف، ثم اضربه في عدد الصفوف التي تخطط لتخزينها.
    2. **Apply the compression coefficient:** حمِّل عينة إلى ClickHouse وقارن بين حجم البيانات الأصلي وحجم الجدول المخزَّن. فعلى سبيل المثال، تُضغط بيانات Clickstream عادةً بمعدل يتراوح بين 6 و10 مرات.
    3. **Account for replicas:** إذا كنت تخطط لتخزين البيانات في عدة نسخ متماثلة، فاضرب الحجم التقديري في عدد النسخ المتماثلة.

    للاطلاع على متطلبات الأجهزة بمزيد من التفصيل، راجع ["توصيات تحديد السعة والأجهزة"](/ar/guides/oss/best-practices/sizing-and-hardware-recommendations)
  </Step>

  <Step>
    ## نزّل وثبّت أحدث إصدار مستقر

    يمكن تنزيل الإصدار المطلوب باستخدام `curl` أو `wget` من المستودع [https://packages.clickhouse.com/tgz/](https://packages.clickhouse.com/tgz/).
    بعد ذلك، يجب فك ضغط الأرشيفات التي تم تنزيلها وتثبيتها باستخدام البرامج النصية الخاصة بالتثبيت.

    فيما يلي مثال على كيفية تثبيت أحدث إصدار مستقر.

    <Note>
      بالنسبة إلى بيئات production، يُوصى باستخدام أحدث إصدار `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 ;;         # لمعالجات Intel/AMD ذات 64 بت
      aarch64) ARCH=arm64 ;;        # لمعالجات ARM ذات 64 بت
      *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # اخرج إذا كانت المعمارية غير مدعومة
    esac
    ```
  </Step>

  <Step>
    ## نزّل ملفات tarball لكل مكوّن من مكوّنات ClickHouse

    نزّل ملفات tarball لكل مكوّن من مكوّنات 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>