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

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

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

إن [حزمة أدوات Overleaf↗](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/Pro، نوصي بالترقية إلى أحدث إصدار من الإصدار الرئيسي المنشور **قبل** الترقية إلى أحدث إصدار من **التالي** الإصدار الرئيسي. إذا كان النشر لديك متأخرًا بأكثر من إصدار رئيسي واحد عن الأحدث، فستحتاج إلى إجراء ترقية متعددة المراحل.

على سبيل المثال، إذا كنت تشغّل 3.5.10، فستحتاج إلى الترقية إلى 3.5.13 -> تنفيذ ترحيل سجل المشروع الكامل -> 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://overleaf-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.