> ## 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.

# استكشاف الأخطاء وإصلاحها

> المشكلات التي تظهر عند تشغيل Ayakaleaf Pro باستخدام Docker Desktop على macOS، وكيفية التحقق منها.

### تفشل التهيئة مع invalid command code

يُبلغ `bin/init` عن `sed: ... invalid command code` عندما يجد BSD sed الخاص بـ macOS. ضع GNU sed في `PATH` كما في [1. تنزيل Toolkit](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md) وتحقّق من `sed --version`.

قد تترك تهيئة فاشلة الملفات الثلاثة في `config/` مع قيمة فارغة لـ `OVERLEAF_INVITE_TOKEN_SECRET`. ثم يُبلغ تشغيل `bin/init` مجددًا عن `Config files already exist`. لتثبيت جديد لم يبدأ قط، انقل الملفات الثلاثة إلى مجلد نسخ احتياطي وشغّل `bin/init` مجددًا. أما لنسخة قائمة، فاحتفظ بإعداداتها وأسرارها، ولا تحذف ملفاتها لكي يعمل `bin/init` مجددًا.

### يستمر MongoDB في إعادة التشغيل

اقرأ سجلات MongoDB وإصدار نواة آلة Docker الافتراضية:

```bash theme={null}
bin/docker-compose logs --tail=100 mongo
docker info --format '{{.KernelVersion}}'
```

إذا ذكر السجل عدم التوافق مع نواة Linux، فاتبع [تحقّق من نواة Linux في آلة Docker الافتراضية](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md#check-the-docker-vms-linux-kernel) وشغّل `bin/up -d` مجددًا. لا يثبت رمز الخروج `137` وحده أن الذاكرة نفدت لدى MongoDB: تحقّق من حالة الحاوية ومن السجلات. لمشكلة أقدم في MongoDB على Docker Desktop، راجع أيضًا [استكشاف الأخطاء وإصلاحها](https://ayakaleaf-pro.mintlify.site/ar/on-premises/support/troubleshooting.md).

### تعذّر الاتصال بـ Docker daemon

شغّل Docker Desktop وتحقّق من سياق Docker المحدد، راجع [0. إعداد Docker Desktop](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md). إذا عمل `docker info` لكن عمليات الترجمة لا تستطيع الوصول إلى Docker، فتحقّق من إعدادات الـ socket في `config/overleaf.rc` واقرأ سجلات `clsi`. إن عمل Docker CLI على جهاز Mac لا يثبت أن تركيب الـ socket الخاص بالتطبيق صحيح.

### تفتح الصفحة، لكن عمليات الترجمة تفشل

تحقّق من أن صورة TeX Live موجودة محليًا وتطابق بنية محرك Docker:

```bash theme={null}
docker image inspect ghcr.io/ayaka-notes/texlive-full:2026.1 \
  --format '{{.Os}}/{{.Architecture}}'
bin/logs -f clsi
```

على Apple silicon، يجب أن تكون الصورة `linux/arm64`. تحقّق من أن `SERVER_PRO` و`SIBLING_CONTAINERS_ENABLED` كلاهما `true`، ثم طبّق التغييرات باستخدام `bin/up -d`. إذا أبلغت السجلات عن مجلد ترجمة مفقود، فتحقّق من مشاركة الملفات في Docker Desktop ومن موقع `OVERLEAF_DATA_PATH`. لا تعطّل Sandboxed Compiles لإخفاء فشل في التركيب.

### Not a directory، أو ربط تركيب (bind mount) مفقود

ربما حُذف ملف على المضيف يركّبه ملف تجاوز (override)، أو ربما أنشأ Docker مجلدًا في المكان الذي يجب أن يكون فيه الملف. تحقّق من مسار المصدر على المضيف، ومما إذا كان التركيب يتوقع ملفًا أم مجلدًا. استعد ملف الإعدادات قبل إعادة إنشاء الحاوية. قد يواجه تثبيت ضمن `/tmp` هذه المشكلة بعد أن يحذف macOS الملفات المؤقتة.

### تعارض المنافذ أو أسماء الحاويات

إذا كان المنفذ `8080` مستخدمًا، فاختر منفذًا آخر في `config/overleaf.rc`، واضبط `OVERLEAF_SITE_URL` ليطابقه، وشغّل `bin/up -d` مجددًا.

يعطي Toolkit حاوياته أسماء ثابتة مثل `sharelatex` و`mongo` و`redis`. لا يكفي تغيير `PROJECT_NAME` وحده لجعل تثبيتين من Toolkit مستقلين. قبل تشغيل نسخة ثانية، تحقّق من `docker ps -a`، واستخدم أسماء حاويات أخرى في ملف تجاوز لـ Compose، ومنفذًا آخر، ومجلدات بيانات منفصلة. لا تحذف حاويات أو بيانات نشر قائم لحل تعارض في الأسماء.

### يتعذّر الوصول إلى النسخة بعد فترة

على الأرجح دخل جهاز Mac في وضع السكون، أو أُغلق Docker Desktop. راجع [إبقاء النسخة متاحة](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### يقول `bin/doctor` إن هذا ليس Linux، أو يطلب تسجيل الدخول إلى Quay

كلا التحذيرين متوقعان على macOS مع الصورة العامة، راجع [2. تعرّف على الـ Toolkit](https://ayakaleaf-pro.mintlify.site/ar/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md). تحقّق بدلًا من ذلك من سحب الصور وحالة الخدمات ونتائج الترجمة، ولا تتجاهل الأخطاء الأخرى في التقرير.


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