How to Integrate Collabora Online with ownCloud Infinite Scale

Integrating Collabora Online with ownCloud Infinite Scale (oCIS) is a WOPI integration, not the same setup used by ownCloud Classic. WOPI, or Web Application Open Platform Interface, is the protocol that lets an online office suite request a file from a storage platform, edit it in the browser, and write the result back.

That distinction matters because current Infinite Scale deployments use the built-in collaboration service as the bridge between oCIS and Collabora. You do not install the old ownCloud Classic Collabora app and point it at a server URL. The office application is registered through the collaboration and app-registry services instead. The official ownCloud WOPI documentation lists Collabora as a supported office application, while the collaboration service documentation explains the service and its required settings.

As of October 2026, ownCloud's official GitHub releases include Infinite Scale 8.2.0, released August 10, 2026. The project's deployment example may evolve independently, so use a tested production tag rather than assuming a rolling image is appropriate. The official oCIS full deployment example currently recommends Collabora CODE tag 26.04.3.1.1 in its environment file. Check the official Infinite Scale releases and the official deployment example environment file before pinning versions.

First, Understand the Three Endpoints

A production integration normally involves three logical endpoints:

Verified: COLLABORATION_APP_ADDR is the Collabora URL, and COLLABORATION_WOPI_SRC identifies the WOPI source used by the office application. Environment-dependent: the WOPI source does not have to be a separate public hostname when Collabora and the collaboration service share a trusted container network. The current official Compose example uses http://collaboration:9300 internally. A separated deployment may require a routed HTTPS WOPI hostname.

Useful action: decide your topology before copying configuration values. If all components run in one official Compose stack, start from that example. If Collabora is on another host or Kubernetes cluster, document which DNS name each side can actually resolve and reach.

Stage 1: Verify DNS, HTTPS, and Collabora Discovery

Before touching oCIS configuration, make sure the ownCloud and Collabora names resolve correctly and that Collabora exposes its discovery endpoint. Collabora publishes WOPI capabilities through /hosting/discovery. A basic check is:

dig +short cloud.example.com
dig +short office.example.com

curl -fsS https://office.example.com/hosting/discovery | head

You should receive XML from the discovery endpoint. If TLS terminates at a reverse proxy, confirm that the certificate presented for office.example.com is valid from the perspective of the oCIS host or container network.

Caption: Check name resolution and the Collabora /hosting/discovery endpoint before debugging WOPI registration inside Infinite Scale.

Common misunderstanding: seeing a Collabora landing page in a browser does not prove the WOPI integration works. It proves the web endpoint is reachable. The collaboration service must also reach Collabora, and Collabora must be able to reach the WOPI source.

Useful action: run connectivity tests from the same network namespace as the relevant service—for example, from inside the collaboration container when using Docker.

Stage 2: Configure the Infinite Scale Collaboration Service

The collaboration service is not started automatically by a generic ocis server supervised-mode setup. The ownCloud documentation states that it must be started explicitly, because administrators may run more than one collaboration-service instance for different office products.

The important settings for Collabora are:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.com

The exact WOPI source above matches the topology used by the current official Compose example: Collabora and the collaboration service share the same Docker network. If your Collabora server is external, replace the internal URL with the address that Collabora can reach.

The service also depends on Infinite Scale's gateway and app-provider infrastructure. In a split-container deployment, the ownCloud documentation specifically warns that the oCIS configuration must be shared with the collaboration container because generated secrets are required across services. See the current official Collabora Compose definition.

Caption: A collaboration-service process should start with the intended Collabora address and WOPI source; use real service logs to confirm the values in your deployment.

Useful action: if you built the deployment manually, compare your environment against the official collabora.yml instead of copying settings from an old cs3org/wopiserver tutorial.

Stage 3: Configure Collabora for the WOPI Host and Browser Embedding

Collabora must trust the WOPI host and be allowed to render inside the ownCloud Web page. The official oCIS Compose example passes Collabora options that terminate TLS at the reverse proxy and set net.frame_ancestors to the oCIS domain. It also generates a WOPI proof key before starting Collabora.

In the official example, relevant Collabora-side values include:

DONT_GEN_SSL_CERT=YES

extra_params:
  --o:ssl.enable=...
  --o:ssl.ssl_verification=...
  --o:ssl.termination=true
  --o:welcome.enable=false
  --o:net.frame_ancestors=cloud.example.com

تعتمد علامات SSL المحددة على مكان انتهاء TLS. يُوصى باستخدام HTTPS مع تفعيل التحقق من الشهادة عند الاتصال بالإنترنت. INSECURE=trueيتوفر خيار المثال للإعدادات المحلية التي تستخدم شهادات موقعة ذاتيًا؛ بينما يُشير دليل نشر ownCloud صراحةً إلى ضرورة إزالته أو تعطيله للخوادم العامة.

التعليق: نقطة نهاية Collabora التي يمكن الوصول إليها هي أحد المتطلبات الأساسية؛ يجب أن تعرض عمليات النشر الإنتاجية هذه النقطة من خلال HTTPS بشهادة موثوقة من قبل المكونات الأخرى.

إجراء مفيد: إذا نتج عن تحميل المستند إطار iframe فارغ أو خطأ في سياسة أمان المحتوى (CSP)، فافحص أدوات مطوري المتصفح وعناوين الخادم الوكيل العكسي. لا تُعطّل التحقق من الشهادة أو قيود أمان المحتوى بشكل عام لمجرد تحميل الصفحة.

المرحلة الرابعة: أنواع ملفات مكتب التسجيل واختبار التحرير

تُحدد خدمة سجل التطبيقات في Infinite Scale التطبيقَ المُخوّل بفتح كل نوع من أنواع MIME. يُمكن ضبط إعداداتها لتحديد نوع MIME، والامتداد، والأيقونة، والتطبيق الافتراضي، وما إذا كان بإمكان المستخدمين إنشاء ملفات جديدة من هذا النوع. يُمكن الاطلاع على وصف هذه الحقول في وثائق سجل التطبيقات الرسمية .

من التفاصيل الأساسية أن اسم التطبيق المستخدم في السجل يجب أن يتطابق مع اسم موفر التعاون الذي قمت بتسجيله فعليًا. تستخدم أمثلة نشر Collabora الرسمية الحالية اسم المنتج CollaboraOnline"as " COLLABORATION_APP_NAMEو Collabora"as". لا تستخدم أسماءً منسوخة من أمثلة أقدم دون التحقق من إصدار النشر.

بعد بدء التشغيل، سجّل الدخول إلى ownCloud Web وافتح مستند Office مدعومًا. تبدو العملية الناجحة كما يلي:

• يقوم برنامج ownCloud Web بتحديد تطبيق المكتب المسجل لنوع MIME الخاص بالمستند.
• تقوم خدمة التعاون بإنشاء معلومات إطلاق WOPI.
• يتم تحميل برنامج Collabora في المتصفح ويطلب الملف من خلال WOPI.
• تُعاد كتابة التعديلات إلى Infinite Scale من خلال نفس التكامل.

التعليق: الاختبار النهائي هو فتح مستند مكتبي حقيقي من ownCloud Web، وتحريره في Collabora، وإغلاقه، والتأكد من أن النسخة المحفوظة مرئية مرة أخرى في Infinite Scale.

إجراء مفيد: قم بإجراء تغيير بسيط على مستند اختبار مؤقت، ثم أغلق المحرر، وأعد فتح الملف، وتحقق من استمرار التغيير. لا تُعد الصفحة التي تُحمّل المحرر فقط اختبارًا كاملاً لمسار الكتابة.

استخدم مثال Compose الرسمي عندما لا تحتاج إلى بنية مخصصة

بالنسبة لنشر Docker التقليدي، يُعدّ مثال ownCloud المُدار الخيار الأقل مخاطرة ocis_full. يتضمن هذا المثال Infinite Scale، وخدمة التعاون Collabora، وTraefik. يشير الدليل الرسمي إلى أن النشر يتطلب نطاقات لـ oCIS وCollabora، ويوثّق مكون WOPI كجزء من حزمة البرامج. راجع دليل النشر الكامل الرسمي .

يتضمن ملف بيئة الإنتاج النموذجي قيمًا على النحو التالي:

OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com

COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com

INSECURE=false

ثم ابدأ المكدس بما يلي:

docker compose pull
docker compose up -d
docker compose ps

تم التحقق: يُتيح مثال الخادم الوكيل العكسي الرسمي الحالي استخدام الشرطات المائلة المشفرة وعلامات الاستفهام وعلامات النسبة المئوية على نقطة دخول HTTPS لأن التعاون/Collabora يتطلبها. يعتمد على البيئة: إذا كنت تستخدم Nginx أو HAProxy أو وحدة تحكم الدخول أو موازن تحميل سحابي بدلاً من Traefik، فيجب عليك إعادة إنتاج معالجة عناوين URL المطلوبة وسلوك WebSocket/الوكيل والشهادات ومهلات الوصول في تلك المنصة.

إجراء مفيد: لا تقم بترجمة تسميات Traefik حرفيًا إلى وكيل آخر. استخدمها لفهم متطلبات التوجيه، ثم قم بتنفيذ تلك المتطلبات باستخدام الصيغة الموثقة للوكيل الخاص بك.

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

ما هو معروف، وما يعتمد على عملية النشر، وما يجب تجنبه من افتراضات

المعروف: يدعم Infinite Scale منصة Collabora من خلال WOPI، وخدمة التعاون المدمجة هي الجسر الحالي، ويوفر النشر الكامل الرسمي بنية مرجعية عملية.

يعتمد ذلك على بيئتك: ما إذا كانت نقطة نهاية WOPI عبارة عن عنوان URL داخلي للحاوية أو اسم مضيف عام، وأين ينتهي TLS، وما هو الوكيل الذي تستخدمه، وما إذا كان Collabora يعمل في نفس الشبكة مثل oCIS.

لا تفترض أن تعليمات ownCloud Classic تنطبق على Infinite Scale. فالوثائق الخاصة بـ Classic التي تنصحك بتثبيت تطبيق Collabora/richdocuments أو تهيئته عبر واجهة إدارة Classic، تصف بنية منتج مختلفة.

وبالتالي فإن سير العمل الأكثر موثوقية للتكامل هو: البدء من نموذج النشر الرسمي لـ Infinite Scale، وإثبات إمكانية الوصول إلى الشبكة وTLS، وتكوين خدمة التعاون، والتأكد من أن Collabora تثق ويمكنها الوصول إلى مضيف WOPI، وتسجيل أنواع MIME ذات الصلة، وأخيرًا اختبار كل من فتح وحفظ مستند حقيقي.