> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ترقية عملية النشر

<Danger>
  من المهم التأكد من أخذ [نسخة احتياطية متسقة](/ar/on-premises/maintenance/data-and-backups#performing-a-consistent-backup) **قبل** كل ترقية لإصدار رئيسي، حتى تتمكن من التراجع إذا احتجت إلى ذلك.
</Danger>

إن [ayakaleaf toolkit↗](https://github.com/ayaka-notes/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.

<Info>
  بالنسبة للبيئات المعزولة عن الشبكة (air-gapped) التي تستورد صور Docker يدويًا، يُرجى ضبط `PULL_BEFORE_UPGRADE=false` في ملف `config/overleaf.rc`.

  يُرجى الاطلاع [هنا](/ar/on-premises/installation/air-gapped-offline-deployments) لمزيد من المعلومات حول النشر في البيئات المعزولة عن الشبكة/غير المتصلة.
</Info>

### مسار الترقية

إذا كنت تشغّل إصدارًا أقدم من Overleaf Community سابقًا للإصدار v6.0.0، فارجع إلى [وثائق Overleaf الرسمية](https://docs.overleaf.com/on-premises/maintenance/upgrading-your-deployment#upgrade-path) لإكمال الترقية.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.