> 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/alsyanh/upgrading-your-deployment.md).

# ترقية بيئة النشر الخاصة بك

{% hint style="danger" %}
من المهم التأكد من أخذ [نسخة احتياطية متسقة](/on-premises/ar/alsyanh/data-and-backups.md#performing-a-consistent-backup) **قبل** مع كل ترقية لإصدار رئيسي لكي تتمكن من الرجوع إذا احتجت إلى ذلك.
{% endhint %}

يجب أن يكون [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) هو مستودع git، لذا من السهل الحصول على ميزات Toolkit الجديدة. ما عليك سوى تشغيل الأمر `bin/upgrade` واتباع التعليمات الظاهرة على الشاشة.

يجدر بالذكر أن إصدار صورة Docker (في `config/version`) يُدار بشكل منفصل عن تحديثات كود Toolkit. إن تحديث كود Toolkit سيؤدي إلى **لا** تغيير إصدار صورة Docker التي تشغّلها تلقائيًا. وهذا يعني أنه في معظم الحالات يمكنك ترقية إصدار Toolkit لديك دون ترقية عملية النشر.

#### يجب أن يكون `bin/upgrade` السكريبت

عندما تُشغّل `bin/upgrade` الأمر، سيتحقق السكريبت مما إذا كان هناك تحديث متاح لكود Toolkit، وسيعرض ترقية Toolkit لديك. يمكنك دائمًا رفض هذه الترقية، ولن يتغير شيء.

إذا اخترت بالفعل تحديث كود Toolkit، فسيتحقق السكريبت بعد ذلك مما إذا كان *الافتراضي* إصدار صورة Docker الافتراضي قد تغيّر، وسيعرض ترقية ملف الإصدار المحلي لديك (في `config/version`) ليتطابق مع الافتراضي الجديد.

إذا اخترت التبديل بين الإصدارات، فسيرشدك السكريبت بعد ذلك خلال عملية إيقاف خدمات Docker، وأخذ نسخة احتياطية، وإعادة تشغيل خدمات Docker. سيتم نسخ ملف الإصدار القديم تلقائيًا إلى `config/__old-version`، وذلك في حال احتجت إلى الرجوع إلى ذلك الإصدار من صور Docker.

{% hint style="danger" %}
عند إجراء ترقية لـ Server CE/Server Pro، نوصي بالترقية إلى أحدث إصدار من الإصدار الرئيسي المنشور **قبل** الترقية إلى أحدث إصدار من **التالية** الإصدار الرئيسي. إذا كان النشر لديك متأخرًا عن أحدث إصدار بأكثر من إصدار رئيسي واحد، فسيُطلب منك إجراء ترقية متعددة الخطوات.

على سبيل المثال، إذا كنت تستخدم 3.5.10، فستحتاج إلى الترقية إلى 3.5.13 -> إجراء ترحيل Full Project History الكامل -> 4.2.9 -> 5.5.4.

يجب عليك **أبدًا** تتجاوز الإصدارات الرئيسية (3.5.10 -> 5.5.4). إذا كنت تستخدم Toolkit، وكنت متأخرًا عن أحدث إصدار بأكثر من إصدار رئيسي واحد، فيجب عليك **لا** استخدام `bin/upgrade` البرنامج النصي لأنك ستحتاج إلى إجراء ترقية يدوية متعددة الخطوات.
{% endhint %}

{% hint style="info" %}
بالنسبة للإعدادات المعزولة عن الشبكة التي تستورد صور Docker يدويًا، يرجى تعيين `PULL_BEFORE_UPGRADE=false` في ملف `config/overleaf.rc` الملف.

يرجى مراجعة [هنا](/on-premises/ar/altthbyt/air-gapped-offline-deployments.md) لمزيد من المعلومات حول النشر في بيئات معزولة عن الشبكة/غير متصلة.
{% endhint %}

### مسار الترقية <a href="#upgrade-path" id="upgrade-path"></a>

يجب أن يكون `bin/upgrade` سيختار الأمر دائمًا أحدث إصدار من Server Pro/CE متاحًا له في ذلك الوقت. إذا كانت دورة الترقية لديك غير متكررة، فقد يؤدي ذلك إلى تخطي الإصدارات الرئيسية، وربما الترقية إلى إصدار لم تكن تتوقعه.

عند تنفيذ الترقية نوصي بالترقية إلى أحدث إصدار من النسخة الرئيسية الحالية قبل الترقية إلى أحدث إصدار من النسخة الرئيسية التالية. على سبيل المثال، إذا كنت تستخدم حاليًا 3.3.2 وكان أحدث إصدار متاح هو 5.3.1، فسيكون مسار الترقية الصحيح هو:

* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1

لتجنب أي مشكلات في الترقية، نوصي بالاطلاع على [ملاحظات الإصدار](https://docs.overleaf.com/on-premises/release-notes) قبل إجراء أي ترقيات، إذ قد تتطلب بعض الإصدارات خطوات إضافية، مثل إجراء تغييرات يدوية على Toolkit، أو ترقية قواعد البيانات، أو تشغيل نصوص الترحيل.

إذا لم تكن قد فعلت ذلك بالفعل، فالاشتراك في [القائمة البريدية](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) حتى تتلقى إشعارًا عند إصدار إصدارات/تحديثات جديدة. وهذا سيسمح لك بجدولة نوافذ صيانة منتظمة تتوافق بشكل وثيق مع جدول إصداراتنا.


---

# 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/alsyanh/upgrading-your-deployment.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.