# Documentation

> Official Nibleaf product documentation for Cloud, self-hosting, authoring, publishing, search, Arabic RTL, migration, and operations.

## Docs (English)

- [Choose your Nibleaf path](https://docs.nibleaf.com/getting-started/introduction.md): Decide between Nibleaf Cloud and self-hosting, understand the publishing model, and reach a useful first result without guessing.
- [Write and review a page](https://docs.nibleaf.com/use-nibleaf/authoring.md): Choose an editing mode, organize the page tree, use branches and anchored comments, and recover safely when a draft does not render.
- [Protect documentation with private reader access](https://docs.nibleaf.com/secure-access/private-reader-access.md): Choose workspace or reader access, configure audiences and portal JWT handoff, and recover quickly from a compromised reader integration.
- [Configure a production deployment](https://docs.nibleaf.com/self-hosting/configuration.md): Set public origins, independent secrets, object storage, email, domain routing, proxy trust, and operator access for self-hosted Nibleaf.
- [August 2026 source capability notes](https://docs.nibleaf.com/releases/august-2026-capabilities.md): Review the six merged source capabilities, their product boundaries, migration requirements, and availability before planning an upgrade.
- [Production environment variables](https://docs.nibleaf.com/reference/environment-variables.md): Look up the production image, origin, domain, secret, storage, authentication, email, proxy, worker, and lifecycle settings Nibleaf consumes.
- [Contribute to Nibleaf documentation](https://docs.nibleaf.com/contribute/documentation.md): Propose, write, validate, review, publish, and maintain Nibleaf documentation changes with reproducible evidence and product-truth checks.
- [Publish your first Cloud project](https://docs.nibleaf.com/getting-started/cloud.md): Create a Nibleaf Cloud workspace, replace the starter content, publish two pages, and verify the reader experience while signed out.
- [Choose, customize, and share a documentation theme](https://docs.nibleaf.com/use-nibleaf/themes.md): Use Nibleaf themes safely across previews and published documentation, then export or import a validated, versioned theme template.
- [Connect MCP clients securely](https://docs.nibleaf.com/self-hosting/mcp.md): Enable the project-bound Nibleaf MCP endpoint, issue least-privilege keys, configure a client, rotate access, and operate the audit and rate-limit boundaries.
- [Integrations engine](https://docs.nibleaf.com/reference/integrations-engine.md): Understand provider ownership, secure project connections, lifecycle actions, MCP boundaries, and safe migration or key rotation.
- [Install Nibleaf on one Linux server](https://docs.nibleaf.com/getting-started/self-hosted.md): Install the pinned Nibleaf release with the guided installer or Docker Compose, then verify migrations, sign-up, storage, and publishing.
- [Configure project add-ons and consent controls](https://docs.nibleaf.com/use-nibleaf/add-ons.md): Enable reader actions, consent controls, preview access, and local publishing checks while preserving entitlement and audit boundaries.
- [Operate hybrid search and grounded answers](https://docs.nibleaf.com/self-hosting/search-ai.md): Index published documentation in Qdrant, evaluate shadow traffic, cut over safely, and operate optional grounded AI answers.
- [Nibleaf API and OpenAPI reference](https://docs.nibleaf.com/reference/api.md): Find the self-hosted server specification, understand browser-session authentication, and separate Nibleaf APIs from published customer API references.
- [Markdown and MDX component reference](https://docs.nibleaf.com/use-nibleaf/markdown-mdx.md): Use the Markdown, GitHub-style extensions, math, diagrams, and documentation components that Nibleaf renders and round-trips safely.
- [Take a self-hosted installation to production](https://docs.nibleaf.com/self-hosting/production.md): Prove DNS, TLS, service health, storage, email, search, security, monitoring, and recovery before a self-hosted Nibleaf launch.
- [Known limitations and product boundaries](https://docs.nibleaf.com/reference/known-limitations.md): Evaluate Nibleaf honestly against beta operations, identity, Git workflows, API portals, exports, private readers, and search requirements.
- [Connect a repository for bidirectional Git authoring](https://docs.nibleaf.com/use-nibleaf/git-authoring.md): Connect GitHub with least-privilege credentials, publish browser edits through a draft pull request, and recover safely from conflicts.
- [Migrate and roll back the combined capability release](https://docs.nibleaf.com/self-hosting/combined-release-migration.md): Apply the search, usage, add-on, integration, and MCP migrations in dependency order, verify degraded states, and reverse them safely.
- [Publish and verify a documentation version](https://docs.nibleaf.com/use-nibleaf/publishing.md): Turn the reviewed default-branch draft into an immutable snapshot, verify the public response, and recover from a failed publish.
- [Operate ClickHouse analytics](https://docs.nibleaf.com/self-hosting/clickhouse-analytics.md): Migrate, secure, reconcile, retain, back up, and roll back Nibleaf product analytics without making documentation delivery depend on ClickHouse.
- [Export and archive a published documentation version](https://docs.nibleaf.com/use-nibleaf/exports.md): Create portable Markdown, PDF, or static HTML artifacts from one immutable published version, then automate retention with archive schedules.
- [Operate usage metering](https://docs.nibleaf.com/self-hosting/usage-metering.md): Configure, reconcile, retain, export, delete, and roll back provider-neutral Nibleaf usage without enabling payments.
- [Configure and validate redirect rules](https://docs.nibleaf.com/use-nibleaf/redirects.md): Define safe internal or external redirects, understand route-graph validation, and publish redirects without risking the current live version.
- [Back up, restore, and upgrade Nibleaf](https://docs.nibleaf.com/self-hosting/backups-upgrades.md): Capture Postgres and object storage as one recovery set, test restoration in isolation, and upgrade or roll back a pinned Nibleaf release.
- [Publish Arabic and right-to-left documentation](https://docs.nibleaf.com/use-nibleaf/arabic-rtl.md): Create an Arabic page tree, connect real translations, and verify direction, mixed technical text, search, metadata, and mobile navigation.
- [Troubleshoot a self-hosted deployment](https://docs.nibleaf.com/self-hosting/troubleshooting.md): Diagnose startup, migration, storage, email, publishing, domain, proxy, and search failures without destroying recoverable state.
- [Migrate documentation into Nibleaf](https://docs.nibleaf.com/use-nibleaf/migration.md): Plan a reversible migration from Mintlify, Ghost, or a public Markdown repository, then verify content parity before changing DNS.

## Docs (العربية)

- [اختر مسارك مع Nibleaf](https://docs.nibleaf.com/getting-started/introduction.md?lang=ar): اختر بين Nibleaf Cloud والاستضافة الذاتية، وافهم نموذج النشر، وحقق أول نتيجة مفيدة دون تخمين.
- [اكتب صفحة وراجعها](https://docs.nibleaf.com/use-nibleaf/authoring.md?lang=ar): اختر وضع التحرير، ونظّم شجرة الصفحات، واستخدم الفروع والتعليقات المثبتة، واستعد بأمان عندما لا تظهر المسودة.
- [حماية التوثيق بوصول خاص للقرّاء](https://docs.nibleaf.com/secure-access/private-reader-access.md?lang=ar): اختر وصول مساحة العمل أو وصول القرّاء، واضبط الجماهير وتسليم JWT من البوابة، وتعافَ سريعًا من اختراق تكامل القرّاء.
- [تهيئة عملية نشر لبيئة الإنتاج](https://docs.nibleaf.com/self-hosting/configuration.md?lang=ar): اضبط المصادر العامة، والأسرار المستقلة، وتخزين الكائنات، والبريد الإلكتروني، وتوجيه النطاق، والثقة بالوكيل، ووصول المشغّلين إلى Nibleaf المستضاف ذاتيًا.
- [ملاحظات إمكانات المصدر لأغسطس 2026](https://docs.nibleaf.com/releases/august-2026-capabilities.md?lang=ar): راجع إمكانات المصدر الست المدمجة وحدود المنتج ومتطلبات الترحيل وحالة الإتاحة قبل التخطيط للترقية.
- [متغيّرات بيئة الإنتاج](https://docs.nibleaf.com/reference/environment-variables.md?lang=ar): ارجع إلى إعدادات صورة بيئة الإنتاج والمصدر والنطاق والأسرار والتخزين والمصادقة والبريد والوكيل وعامل المعالجة ودورة الحياة التي يستخدمها Nibleaf.
- [المساهمة في توثيق Nibleaf](https://docs.nibleaf.com/contribute/documentation.md?lang=ar): اقترح تغييرات توثيق Nibleaf واكتبها وتحقق منها وراجعها وانشرها وحافظ عليها بأدلة قابلة لإعادة الإنتاج وفحوص تستند إلى حقيقة المنتج.
- [انشر أول مشروع لك على Cloud](https://docs.nibleaf.com/getting-started/cloud.md?lang=ar): أنشئ مساحة عمل على Nibleaf Cloud، واستبدل المحتوى الابتدائي، وانشر صفحتين، وتحقق من تجربة القارئ بعد تسجيل الخروج.
- [اختيار سمة التوثيق وتخصيصها ومشاركتها](https://docs.nibleaf.com/use-nibleaf/themes.md?lang=ar): استخدم سمات Nibleaf بأمان في المعاينة والتوثيق المنشور، ثم صدّر قالب سمة مُصدّرًا أو استورده وفق مخطط مُتحقق منه وذي إصدار.
- [ربط عملاء MCP بأمان](https://docs.nibleaf.com/self-hosting/mcp.md?lang=ar): فعّل نقطة MCP المرتبطة بالمشروع في Nibleaf، وأنشئ مفاتيح بأقل صلاحية، واضبط العميل، ودوّر الوصول، وشغّل حدود التدقيق وتحديد المعدل.
- [محرك التكاملات](https://docs.nibleaf.com/reference/integrations-engine.md?lang=ar): تعرّف على ملكية المزوّدين واتصالات المشاريع الآمنة وإجراءات دورة الحياة وحدود MCP والترحيل وتدوير المفاتيح بأمان.
- [ثبّت Nibleaf على خادم Linux واحد](https://docs.nibleaf.com/getting-started/self-hosted.md?lang=ar): ثبّت إصدار Nibleaf المثبّت باستخدام برنامج التثبيت الموجّه أو Docker Compose، ثم تحقق من عمليات الترحيل والتسجيل والتخزين والنشر.
- [تهيئة إضافات المشروع وضوابط الموافقة](https://docs.nibleaf.com/use-nibleaf/add-ons.md?lang=ar): فعّل إجراءات القرّاء وضوابط الموافقة والمعاينة وفحوص النشر المحلية مع الحفاظ على حدود الاستحقاق وسجل التدقيق.
- [تشغيل البحث الهجين والإجابات الموثّقة](https://docs.nibleaf.com/self-hosting/search-ai.md?lang=ar): فهرسة التوثيق المنشور في Qdrant، وتقييم حركة الظل، والانتقال الآمن، وتشغيل إجابات الذكاء الاصطناعي الموثّقة اختيارياً.
- [مرجع واجهة Nibleaf API وOpenAPI](https://docs.nibleaf.com/reference/api.md?lang=ar): اعثر على مواصفات الخادم المستضاف ذاتيًا، وافهم المصادقة بجلسة المتصفح، وميّز واجهات API في Nibleaf من مراجع API المنشورة للعملاء.
- [مرجع Markdown ومكونات MDX](https://docs.nibleaf.com/use-nibleaf/markdown-mdx.md?lang=ar): استخدم Markdown وامتدادات GitHub والرياضيات والمخططات ومكونات التوثيق التي يعرضها Nibleaf ويحوّلها ذهابًا وإيابًا بأمان.
- [نقل تثبيت مستضاف ذاتيًا إلى بيئة الإنتاج](https://docs.nibleaf.com/self-hosting/production.md?lang=ar): أثبت سلامة DNS وTLS والخدمات والتخزين والبريد والبحث والأمان والمراقبة والاستعادة قبل إطلاق Nibleaf مستضاف ذاتيًا.
- [القيود المعروفة وحدود المنتج](https://docs.nibleaf.com/reference/known-limitations.md?lang=ar): قيّم Nibleaf بصدق مقارنةً بمتطلبات تشغيل النسخة التجريبية والهوية ومسارات عمل Git وبوابات API والتصدير والقرّاء الخاصين والبحث.
- [ربط مستودع للتأليف ثنائي الاتجاه عبر Git](https://docs.nibleaf.com/use-nibleaf/git-authoring.md?lang=ar): اربط GitHub ببيانات اعتماد ذات أقل قدر من الصلاحيات، وانشر تعديلات المتصفح عبر طلب سحب في حالة مسودة، وتعافَ من التعارضات بأمان.
- [ترحيل إصدار الإمكانات المجمع والتراجع عنه](https://docs.nibleaf.com/self-hosting/combined-release-migration.md?lang=ar): طبّق ترحيلات البحث والاستخدام والإضافات والتكاملات وMCP بترتيب الاعتماد، وتحقق من حالات التعطل، واعكسها بأمان.
- [انشر إصدارًا من التوثيق وتحقق منه](https://docs.nibleaf.com/use-nibleaf/publishing.md?lang=ar): حوّل مسودة الفرع الافتراضي التي جرت مراجعتها إلى لقطة ثابتة غير قابلة للتغيير، وتحقق من الاستجابة العامة، واستعد بعد فشل النشر.
- [تشغيل تحليلات ClickHouse](https://docs.nibleaf.com/self-hosting/clickhouse-analytics.md?lang=ar): ترحيل تحليلات منتج Nibleaf وتأمينها ومطابقتها والاحتفاظ بها ونسخها احتياطيًا والتراجع عنها من دون ربط إتاحة الوثائق بخدمة ClickHouse.
- [تصدير إصدار منشور من التوثيق وأرشفته](https://docs.nibleaf.com/use-nibleaf/exports.md?lang=ar): أنشئ نواتج Markdown أو PDF أو HTML ثابتًا قابلة للنقل من إصدار منشور واحد غير قابل للتغيير، ثم أتمت الاحتفاظ بها عبر جداول الأرشفة.
- [تشغيل قياس الاستخدام](https://docs.nibleaf.com/self-hosting/usage-metering.md?lang=ar): إعداد استخدام Nibleaf المحايد عن مزود الفوترة وتسويته والاحتفاظ به وتصديره وحذفه والتراجع عنه دون تفعيل المدفوعات.
- [ضبط قواعد إعادة التوجيه والتحقق منها](https://docs.nibleaf.com/use-nibleaf/redirects.md?lang=ar): عرّف عمليات إعادة توجيه داخلية أو خارجية آمنة، وافهم التحقق من الرسم البياني للمسارات، وانشرها من دون تعريض الإصدار الحي الحالي للخطر.
- [نسخ Nibleaf احتياطيًا واستعادته وترقيته](https://docs.nibleaf.com/self-hosting/backups-upgrades.md?lang=ar): اجمع بيانات Postgres وتخزين الكائنات في مجموعة استعادة واحدة، واختبر الاستعادة في بيئة معزولة، ثم رقِّ إصدار Nibleaf المثبّت أو تراجع إلى الإصدار السابق.
- [انشر توثيقًا عربيًا من اليمين إلى اليسار](https://docs.nibleaf.com/use-nibleaf/arabic-rtl.md?lang=ar): أنشئ شجرة صفحات عربية، واربط الترجمات الفعلية، وتحقق من الاتجاه والنص التقني المختلط والبحث والبيانات الوصفية والتنقل على الهاتف.
- [استكشاف أخطاء عملية نشر مستضافة ذاتيًا وإصلاحها](https://docs.nibleaf.com/self-hosting/troubleshooting.md?lang=ar): شخّص أعطال بدء التشغيل والترحيل والتخزين والبريد والنشر والنطاق والوكيل والبحث من دون إتلاف حالة يمكن استعادتها.
- [ترحيل التوثيق إلى Nibleaf](https://docs.nibleaf.com/use-nibleaf/migration.md?lang=ar): خطط لترحيل قابل للعكس من Mintlify أو Ghost أو مستودع Markdown عام، ثم تحقق من تكافؤ المحتوى قبل تغيير DNS.