> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/aliadadat/overleaf-toolkit/toolkit-settings.md).

# إعدادات Toolkit

تصف هذه الصفحة متغيرات البيئة المدعومة في `config/overleaf.rc` ملف عمليات نشر Toolkit.

إن `config/overleaf.rc` يتكون الملف من تعريفات متغيرات بالشكل `NAME=value`. تبدأ الأسطر بـ `#` على أنها تعليقات.

{% hint style="info" %}
من الضروري إعادة إنشاء حاويات Docker بعد تغيير أي شيء في `overleaf.rc` أو `variables.env` بتشغيل `bin/up`.
{% endhint %}

## الحاوية

### `sharelatex`

| الاسم                        | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PROJECT_NAME`               | <p>يعيّن قيمة <code>--project-name</code> الممرَّرة إلى <code>docker-compose</code>. وهذا مفيد عند تشغيل عدة نسخ من Overleaf على مضيف واحد، إذ يمكن لكل نسخة أن يكون لها اسم مشروع مختلف.<br><br>- <strong>افتراضي</strong>: <code>Overleaf</code></p>                                                                                                                                                                                                                                     |
| `OVERLEAF_IMAGE_NAME`        | <p>صورة Docker كما يستخدمها حاوي التطبيق Server Pro/CE. هذا مجرد اسم صورة Docker؛ أما وسم صورة Docker فيُؤخذ من <code>config/version</code>.<br><br>- <strong>الافتراضي:</strong><br>- Server Pro: <code>quay.io/sharelatex/sharelatex-pro</code><br>- Community Edition: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                           |
| `SERVER_PRO`                 | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit باستخدام صورة Server Pro (<code>quay.io/sharelatex/sharelatex-pro</code>) بدلاً من صورة Server CE الافتراضية (<code>sharelatex/sharelatex</code>).<br><br>- <strong>افتراضي</strong>: <code>false</code></p>                                                                                                                                                                                                                              |
| `GIT_BRIDGE_ENABLED`         | <p>اضبطه على <code>true</code> لتمكين ميزة git-bridge (في Server Pro فقط). لمزيد من المعلومات، راجع <a href="https://www.overleaf.com/learn/how-to/Git_integration"><https://www.overleaf.com/learn/how-to/Git_integration></a> توثيق المستخدم.<br><br>- <strong>الافتراضي:</strong> <code>false</code></p>                                                                                                                                                                                |
| `GIT_BRIDGE_IMAGE`           | <p>صورة Docker كما يستخدمها حاوي git-bridge (في Server Pro فقط). هذا مجرد اسم صورة Docker؛ أما وسم صورة Docker فيُؤخذ من <code>config/version</code>.<br><br>- <strong>الافتراضي:</strong> <code>quay.io/sharelatex/git-bridge</code></p>                                                                                                                                                                                                                                                  |
| `GIT_BRIDGE_DATA_PATH`       | يعيّن مسار المجلد الذي سيُركَّب داخل `git-bridge` الحاوية (في Server Pro فقط)، ويُستخدم لتخزين مستودعات git. ويمكن أن يكون هذا إما مسارًا كاملاً (يبدأ بـ `/`) أو مسارًا نسبيًا بالنسبة إلى الدليل الأساسي لأداة Toolkit.                                                                                                                                                                                                                                                                  |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>اضبط مستوى السجل لـ <code>git-bridge</code> الحاوية. المستويات المتاحة: <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>.<br><br>- <strong>الافتراضي:</strong> <code>INFO</code></p>                                                                                                                                                                                                                                                    |
| `SIBLING_CONTAINERS_ENABLED` | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit باستخدام تقنية <strong>الحاويات الشقيقة</strong> لتجميع المشاريع في صناديق رملية منفصلة، باستخدام حاوية Docker منفصلة لكل مشروع. راجع وثائق \<server-pro-only-configuration/sandboxed-compiles> لمزيد من المعلومات.<br><br>- <strong>يتطلب:</strong> <code>SERVER\_PRO=true</code><br>- <strong>الافتراضي:</strong> <code>true</code></p>                                                                                                 |
| `SIBLING_CONTAINERS_PULL`    | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit بسحب جميع صور TeX Live تلقائيًا المضبوطة باستخدام <code>ALL\_TEX\_LIVE\_DOCKER\_IMAGES</code> في <strong>config/variables.env</strong> ملف عند استخدام <code>bin/up</code> الأمر.<br><br>- <strong>الافتراضي:</strong> <code>true</code></p>                                                                                                                                                                                              |
| `DOCKER_SOCKET_PATH`         | <p>يعيّن مسار وصلة Docker على الجهاز المضيف (الجهاز الذي يشغّل Toolkit). عندما <code>SIBLING\_CONTAINERS\_ENABLED</code> هو <code>true</code>، سيتم تركيب الوصلة داخل الحاوية للسماح لخدمة المُجمِّع بإنشاء حاويات Docker جديدة على المضيف.<br><br>- <strong>يتطلب:</strong> <code>SIBLING\_CONTAINERS\_ENABLED=true</code><br>- <strong>الافتراضي:</strong> <code>/var/run/docker.sock</code></p>                                                                                         |
| `OVERLEAF_DATA_PATH`         | <p>يعيّن مسار المجلد الذي سيُركَّب داخل <code>sharelatex</code> الحاوية الرئيسية، ويُستخدم لتخزين بيانات التجميع. ويمكن أن يكون هذا إما مسارًا كاملاً (يبدأ بـ <code>/</code>) أو نسبيًا إلى الدليل الأساسي لأداة Toolkit.<br><br>- <strong>الافتراضي:</strong> <code>data/overleaf</code></p>                                                                                                                                                                                             |
| `OVERLEAF_LISTEN_IP`         | <p>يعيّن عناوين IP للمضيف التي ستربط بها الحاوية. على سبيل المثال، إذا تم ضبط هذا على <code>0.0.0.0</code>، فستكون واجهة الويب متاحة على أي عنوان IP للمضيف. وللوصول المباشر إلى الحاوية يجب أن تكون قيمة <code>OVERLEAF\_LISTEN\_IP</code> يجب ضبطه على عنوان IP العام لديك. إن ضبط <code>OVERLEAF\_LISTEN\_IP</code> إلى أيٍّ من <code>0.0.0.0</code> أو عنوان IP الخارجي لمضيفك سيؤدي عادةً إلى أخطاء عند استخدامه مع .<br><br>- <strong>الافتراضي:</strong> <code>127.0.0.1</code></p> |
| `OVERLEAF_PORT`              | <p>يعيّن منفذ المضيف الذي ستربط به الحاوية. على سبيل المثال، إذا تم ضبط هذا على <code>8099</code> و <code>OVERLEAF\_LISTEN\_IP</code> تم ضبطه على <code>127.0.0.1</code>، فستكون واجهة الويب متاحة على <code><http://localhost:8099></code>.<br><br>- <strong>الافتراضي:</strong> <code>80</code></p>                                                                                                                                                                                      |
| `OVERLEAF_LOG_PATH`          | <p>يعيّن مسار المجلد الذي سيُركَّب داخل <code>sharelatex</code> الحاوية، ويُستخدم لإتاحة سجلات التطبيق على مضيف Docker. ويمكن أن يكون هذا إما مسارًا كاملاً (يبدأ بـ <code>/</code>) أو نسبيًا إلى الدليل الأساسي لأداة Toolkit. أزل مدخل الإعدادات لتعطيل الربط المركّب. عند عدم تعيينه، سيتم تجاهل السجلات عند إعادة إنشاء الحاوية.<br><br>راجع للحصول على معلومات حول التسجيل.<br><br>- <strong>الافتراضي:</strong> غير مضبوط</p>                                                       |

***

### `mongo`

| الاسم             | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MONGO_ENABLED`   | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit بإنشاء حاوية MongoDB لاستضافة قاعدة البيانات. عند ضبطه على <code>false</code>، فلن تُنشأ هذه الحاوية، وسيستخدم النظام قاعدة بيانات MongoDB المحددة بواسطة <code>MONGO\_URL</code> بدلًا من ذلك.<br><br>- <strong>افتراضي</strong>: <code>true</code></p>                                                                                                            |
| `MONGO_URL`       | <p>يحدد عنوان URL لاتصال MongoDB للاستخدام عندما <code>MONGO\_ENABLED</code> هو <code>false</code>.<br><br>- <strong>افتراضي</strong>: غير مضبوط</p>                                                                                                                                                                                                                                                                 |
| `MONGO_DATA_PATH` | <p>يعيّن مسار المجلد الذي سيُركَّب داخل <code>mongo</code> الحاوية، ويُستخدم لتخزين قاعدة بيانات MongoDB. ويمكن أن يكون هذا إما مسارًا كاملاً (يبدأ بـ <code>/</code>) أو نسبيًا إلى الدليل الأساسي لأداة toolkit. يؤثر هذا الخيار فقط في الحاوية المحلية <code>mongo</code> التي يتم إنشاؤها عندما <code>MONGO\_ENABLED</code> هو <code>true</code>.<br><br>- <strong>افتراضي</strong>: <code>data/mongo</code></p> |
| `MONGO_IMAGE`     | <p>صورة Docker كما يستخدمها حاوي MongoDB. هذا مجرد اسم صورة Docker؛ أما وسم صورة Docker فينبغي وضعه في <code>MONGO\_VERSION</code> (انظر أدناه).<br><br>- <strong>الافتراضي:</strong> <code>mongo</code></p>                                                                                                                                                                                                         |
| `MONGO_VERSION`   | <p>إصدار MongoDB كما يستخدمه حاوي MongoDB. يجب أن تبدأ القيمة بإصدار MongoDB الرئيسي ونقطة، مثل <code>6.0</code> أو <code>6.0-with-suffix</code>.<br><br>- <strong>الافتراضي:</strong> <code>6.0</code></p>                                                                                                                                                                                                          |

***

### `redis`

| الاسم                   | الوصف                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `REDIS_ENABLED`         | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit بإنشاء حاوية Redis لاستضافة قاعدة بيانات redis. عند ضبطه على <code>false</code>، فلن تُنشأ هذه الحاوية، وسيستخدم النظام قاعدة بيانات Redis المحددة بواسطة <code>REDIS\_HOST</code> و <code>REDIS\_PORT</code> بدلًا من ذلك.<br><br>- <strong>افتراضي</strong>: <code>true</code></p>                                                                              |
| `REDIS_HOST`            | <p>يحدد مضيف Redis للاستخدام عندما <code>REDIS\_ENABLED</code> هو <code>false</code>.<br><br>- <strong>افتراضي</strong>: غير مضبوط</p>                                                                                                                                                                                                                                                                             |
| `REDIS_PORT`            | <p>يحدد منفذ Redis للاستخدام عندما <code>REDIS\_ENABLED</code> هو <code>false</code>.<br><br>- <strong>افتراضي</strong>: غير مضبوط</p>                                                                                                                                                                                                                                                                             |
| `REDIS_DATA_PATH`       | <p>يعيّن مسار المجلد الذي سيُركَّب داخل <code>redis</code> الحاوية، ويُستخدم لتخزين قاعدة بيانات Redis. ويمكن أن يكون هذا إما مسارًا كاملاً (يبدأ بـ <code>/</code>) أو نسبيًا إلى الدليل الأساسي لأداة Toolkit. يؤثر هذا الخيار فقط في الحاوية المحلية <code>redis</code> التي يتم إنشاؤها عندما <code>REDIS\_ENABLED</code> هو <code>true</code>.<br><br>- <strong>افتراضي</strong>: <code>data/redis</code></p> |
| `REDIS_AOF_PERSISTENCE` | <p>فعّل استمرارية AOF (Append Only File) لـ Redis. هذا هو <strong>الموصى بها</strong> الإعداد الموصى به لاستمرارية Redis.<br><br>لمزيد من التفاصيل، راجع القسم <../../../maintenance/data-and-backups#aof-append-only-file> في <../../maintenance/data-and-backups>.<br><br>- <strong>الافتراضي:</strong> <code>true</code></p>                                                                                    |

***

### `nginx`

| الاسم                  | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NGINX_ENABLED`        | <p>عند ضبطه على <code>true</code>، ويخبر Toolkit بإنشاء حاوية NGINX لتعمل كوكيل TLS.<br><br>- <strong>افتراضي</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                                   |
| `NGINX_CONFIG_PATH`    | <p>مسار ملف إعدادات NGINX لاستخدامه مع وكيل TLS.<br><br>- <strong>افتراضي</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                     |
| `NGINX_TLS_LISTEN_IP`  | <p>يعيّن عناوين IP للمضيف التي سترتبط بها حاوية وكيل TLS عبر HTTPS. على سبيل المثال، إذا تم ضبط هذا على <code>0.0.0.0</code> فستكون واجهة الويب عبر HTTPS متاحة على أي عنوان IP للمضيف. عادةً ينبغي ضبطه على عنوان IP الخارجي لمضيفك.<br><br>- <strong>افتراضي</strong>: <code>127.0.1.1</code></p>                                                                                                                                                              |
| `NGINX_HTTP_LISTEN_IP` | <p>يعيّن عناوين IP للمضيف التي سترتبط بها حاوية وكيل TLS لإعادة التوجيه عبر HTTP. على سبيل المثال، إذا تم ضبط هذا على <code>127.0.1.1</code> فسيتم إعادة توجيه اتصالات HTTP إلى <code>127.0.1.1</code> ستُعاد توجيهها إلى واجهة الويب عبر HTTPS. عادةً ينبغي ضبطه على عنوان IP الخارجي لمضيفك. لا تضبطه على <code>0.0.0.0</code> لأن ذلك سيسبب عادةً تعارضًا مع <code>OVERLEAF\_LISTEN\_IP</code>.<br><br>- <strong>افتراضي</strong>: <code>127.0.1.1</code></p> |
| `NGINX_HTTP_PORT`      | <p>يعيّن منفذ المضيف الذي ستربط به حاوية وكيل TLS عبر HTTP.<br><br>- <strong>افتراضي</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                               |
| `TLS_PORT`             | <p>يعيّن منفذ المضيف الذي ستربط به حاوية وكيل TLS عبر HTTPS.<br><br>- <strong>افتراضي</strong>: <code>443</code></p>                                                                                                                                                                                                                                                                                                                                             |
| `TLS_PRIVATE_KEY_PATH` | <p>مسار المفتاح الخاص لاستخدامه مع وكيل TLS.<br><br>- <strong>افتراضي</strong>: <code>config/nginx/certs/overleaf\_key.pem</code></p>                                                                                                                                                                                                                                                                                                                            |
| `TLS_CERTIFICATE_PATH` | <p>مسار الشهادة العامة لاستخدامها مع وكيل TLS.<br><br>- <strong>افتراضي</strong>: <code>config/nginx/certs/overleaf\_certificate.pem</code></p>                                                                                                                                                                                                                                                                                                                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/aliadadat/overleaf-toolkit/toolkit-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.