Skip to main content

OnlyOffice

Deployment and configuration of OnlyOffice as an optional Docker Compose service.

📋 Prerequisites​

⚠️ To enable OnlyOffice integration, first make sure that the reverse proxy configuration is enabled.

⚡ Activation​

Follow the steps below to enable OnlyOffice with the Nginx reverse proxy.

Nginx configuration​

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

include onlyoffice.conf;

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

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

Docker Compose configuration​

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

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

Sync-in configuration​

In environment.yaml, enable the OnlyOffice integration:

applications:
  files:
    editors:
      onlyoffice:
        # enable integration
        enabled: true
        # use the same secret as in docker-compose.yaml
        secret: 'onlyOfficeSecret'

Replace onlyOfficeSecret with a secure value, then make sure it matches the one defined in ./config/onlyoffice/docker-compose.onlyoffice.yaml:

services:
  onlyoffice:
    environment:
      - 'JWT_SECRET=onlyOfficeSecret'
info

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

🌐 Access​

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

It is essential to access the interface using either the server IP address or a properly configured domain name.

warning

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