> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/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://ayakaleaf-pro.ayaka.space/on-premises/ar/althyeh/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.