Published: October 8, 2025
Last updated: March 10, 2026
Suggest an edit

Configure OnlyOffice Document Server for document editing.

Basic Configuration

YAML 
1
2
3
4

integrations:
  office:
    url: "http://onlyoffice:80"
    secret: "your_secret_here"

Docker Setup

Generate OnlyOffice Secret

Generate a secure secret via OpenSSL

BASH 
1

openssl rand -base64 32

Output example:

TEXT 
1

TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue

Docker Compose Example

YAML 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    ports:
      - "80:80"
    volumes:
      - ./config.yaml:/home/filebrowser/config.yaml
      - ./data:/data
      - ./database.db:/home/filebrowser/database.db
    environment:
      - FILEBROWSER_ONLYOFFICE_SECRET=your_secret_here

  onlyoffice:
    image: onlyoffice/documentserver:latest
    ports:
      - "8080:80"
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=your_secret_here

HTTPS Configuration

For production, use HTTPS with reverse proxy (nginx example):

NGINX 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

server {
    listen 443 ssl;
    server_name office.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://onlyoffice:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

External and Internal URLs

YAML 
1
2
3
4
5
6
7
8
9

server:
  externalUrl: "https://files.yourdomain.com"  # Accessible from browser
  internalUrl: "http://192.168.1.100"         # Either use local network or docker network IP thats accessible from onlyoffice server.

integrations:
  office:
    url: "https://office.yourdomain.com"       # Accessible from browser
    internalUrl: # optional this should be a local network address that FileBrowser can access.
    secret: "your-jwt-secret"

Why two URLs?

  • Browser → The browser always uses integrations.office.url to connect from your browser to only office server.
  • OnlyOffice → Uses either server.externalUrl or server.internalUrl for downloading/saving files to FileBrowser server.
  • FileBrowser → Uses either integratons.office.internalUrl or integrations.office.url to connect from the FileBrowser server to OnlyOffice server.

Next Steps