Collabora Online

Deployment and configuration of Collabora Online as an optional Docker Compose service.

📋 Prerequisites

⚠️ To enable Collabora Online integration, ensure that the reverse proxy configuration is activated first.

⚡ Activation

Follow the steps below to enable Collabora Online with the Nginx reverse proxy.

Nginx configuration

In ./config/nginx/nginx.conf, uncomment the Collabora Online include at the end of the file:

include collabora.conf;

In ./config/nginx/docker-compose.nginx.yaml, ensure that the Collabora Online configuration is mounted in the Nginx container:

services:
  nginx:
    volumes:
      - ./collabora.conf:/etc/nginx/collabora.conf

Docker Compose configuration

In docker-compose.yaml, uncomment the required Docker Compose files:

include:
  - ./config/nginx/docker-compose.nginx.yaml
  - ./config/collabora/docker-compose.collabora.yaml

If you are using HTTPS via the Nginx reverse proxy, edit the ./config/collabora/docker-compose.collabora.yaml file and set the ssl.termination option to true:

services:
  collabora:
    environment:
      extra_params: >-
        --o:ssl.termination=true

Sync-in configuration

In environment.yaml, enable the Collabora Online integration:

server:
  # Optional for now; required in the next major release
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      collabora:
        # enable integration
        enabled: true

info

docker compose up -d && docker compose restart nginx sync_in to apply the changes

🌐 Access

Sync-in and Collabora Online run in Docker containers and communicate via the Nginx reverse proxy.

If you configure server.publicUrl, set it to the exact address used to access Sync-in, including any non-standard port. For example, with an Nginx port mapping of 8060:80, use http://your-server:8060. This URL must be reachable from the browser and from the Collabora Online container. If omitted, Sync-in uses the request origin forwarded by Nginx as a compatibility fallback. For security, server.publicUrl will become required in the next major release so editor endpoints are built from a trusted origin controlled by the administrator rather than from request headers.

warning

Accessing Sync-in via http://localhost or http://127.0.0.1 will prevent Collabora from working properly (documents cannot be displayed or edited).