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

# المزامنة مع GitHub

<Info>
  طُوّرت هذه الميزة بواسطة [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro)، وعدّلها [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep). وهي متاحة بدءًا من الإصدار v6.2.0 وما بعده. لا تزال في مرحلة تجريبية (beta). نحتاج إلى ملاحظاتك إذا واجهت أي مشكلة.
</Info>

<Columns cols={2}>
  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-35.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=e901d54b071a78ae8de0efbb66fb000a" alt="" width="2738" height="1568" data-path="images/on-premises/image-35.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-38.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=90e4cb5dcaa49bd81983dcb8c770056c" alt="" width="2988" height="1980" data-path="images/on-premises/image-38.png" />
    </Frame>
  </Column>

  <Column>
    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-34.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=aa73e00b277a4d01a5339c8a6f91a189" alt="" width="2738" height="1568" data-path="images/on-premises/image-34.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-39.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=26d47eb61da2e7acfab8f5951e3cd67e" alt="" width="2988" height="1980" data-path="images/on-premises/image-39.png" />
    </Frame>
  </Column>
</Columns>

### إعداد المزامنة مع GitHub

<Warning>
  يجب عليك تفعيل [git-bridge](/ar/on-premises/configuration/overleaf-toolkit/git-integration) أولًا قبل استخدام المزامنة مع GitHub.

  ```dotenv title="config/overleaf.rc" theme={null}
  GIT_BRIDGE_ENABLED=true
  ```
</Warning>

انتقل إلى [إعدادات المطورين](https://github.com/settings/developers) لإنشاء تطبيق GitHub OAuth الخاص بك، وانسخ `CLIENT_ID` و`SECRET`.

**ملاحظة**: عنوان URL لاستدعاء OAuth (callback) الخاص بك هو: `${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback`.

بعد ذلك، أضف الإعدادات التالية إلى ملفات متغيرات البيئة الخاصة بـ overleaf.

```dotenv title="config/variables.env" wrap theme={null}
# used to encrypt the user's GitHub access token.
# How to generate: `openssl rand -hex 32`
GITHUB_TOKEN_CIPHER_PASSWORD=0123456789ABCDEFG # changed to yours

# Github Sync Settings
GITHUB_SYNC_ENABLED=true
GITHUB_SYNC_CLIENT_ID=
GITHUB_SYNC_CLIENT_SECRET=

# OAuth callback is: ${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback
# (Optional) GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808
```

<Warning>
  قبل تكوين عنوان URL لاستدعاء GitHub OAuth، تأكد من ضبط `OVERLEAF_SITE_URL` بشكل صحيح.
</Warning>

إذا كنت موجودًا في البر الرئيسي للصين، فقد تحتاج إلى تكوين وكيل (proxy) للوصول إلى GitHub. اضبط متغير البيئة التالي: `GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808`.

<Warning>
  لا تستخدم `127.0.0.1` كمضيف للوكيل. إذا كان الوكيل يعمل على الخادم المضيف، فاستخدم عنوان IP الخاص بالخادم على الشبكة المحلية (مثل `192.168.1.xx`) وتأكد من تكوين الوكيل لقبول الاتصالات من الأجهزة على الشبكة المحلية.
</Warning>


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