> ## 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. **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>
    ## تثبيت ClickHouse باستخدام Nix

    يمكنك استخدام Nix لتثبيت ClickHouse دون إضافته بشكل دائم إلى نظامك:

    ```bash theme={null}
    # تثبيت أحدث إصدار مستقر
    nix shell nixpkgs#clickhouse

    # أو تثبيت إصدار LTS
    nix shell nixpkgs#clickhouse-lts
    ```

    سيؤدي ذلك إلى إتاحة الملف التنفيذي `clickhouse` في جلسة shell الحالية.

    * توفّر الحزمة `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">
  ## نبذة عن حزمة 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)