Published: October 9, 2025
Last updated: July 24, 2026
Suggest an edit

Complete setup for running FileBrowser Quantum with OnlyOffice using Docker Compose on your local network.

Prerequisites

  • Docker and Docker Compose installed
  • Basic understanding of Docker networking
  • FileBrowser Quantum image: gtstef/filebrowser (Docker Hub) or ghcr.io/gtsteffaniak/filebrowser (GitHub Container Registry)

Quick Start

Step 01: Generate JWT Secret

First, generate a strong secret for securing communication between FileBrowser and OnlyOffice:

BASH 
1
2
3
4
5

# Using OpenSSL
openssl rand -base64 32

# Example output:
# TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue=

Step 02: Create Docker Compose File

Create a docker-compose.yaml file:

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

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    ports:
      - "8080:80"
    environment:
      FILEBROWSER_CONFIG: "data/config.yaml"
      FILEBROWSER_DATABASE_PATH: "data/filebrowser.sqlite"
    user: filebrowser # non-root user
    volumes:
      - ./data:/home/filebrowser/data
      - /path/to/folder:/srv # Replace "/path/to/folder" with your desired path, you can also change the internal path '/srv' with another path.
    restart: unless-stopped

  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice
    ports:
      - "8081:80" # You can do the same with the ports, you can replace "8081" in the left side if is used, but don't change the right side.
    environment:
      - JWT_SECRET=TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue=  # Replace with your generated secret
    restart: unless-stopped

Step 03: Create FileBrowser Configuration

Create a data directory and config.yaml. v2.0.0 creates the SQLite database automatically on first run — you do not need to create an empty database file.

BASH 
1

mkdir data && touch data/config.yaml

Then populate the config, see Getting started.

YAML 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

server:
  port: 80 # Should be 80, this is the internal port.
  externalUrl: "http://localhost:8080" # External filebrowser URL
  internalUrl: "http://filebrowser:80" # The filebrowser container name with the internal port.
  sources:
    - name: "files" # You can change this name
      path: "/srv" # The docker volume for your files.
      config:
        defaultEnabled: true

auth:
  adminPassword: yourpassword # Change this with a strong password.

integrations:
  office:
    url: "http://localhost:8081"  # Office URL with the external port which should be accesible from browser -- You can use 'localhost' if you are in the same machine, but if you will use another device, use the IP adress of your machine with port. (eg. 192.168.1.128:8081)
    internalUrl: "http://onlyoffice:80" # This is the container name for only office docker service + its internal port.
    secret: "TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue="  # Same secret as OnlyOffice
    viewOnly: false

userDefaults:
  permissions:
    api: false
    admin: false
    share: false
    realtime: false
    # Default per-source permissions for new scopes (v2.0.0+)
    modify: false
    delete: false
    create: false
    download: true
  disableOnlyOfficeExt: ".md .txt .pdf"   # List of file extensions to disable onlyoffice editor for - only applied to new users.

For editing (not view-only), set modify: true here or enable Modify on the user’s scope in User Management. OnlyOffice requires view on the source; editing also requires modify.

Step 4: Start Services

BASH 
1

docker-compose up -d

Wait for OnlyOffice to fully start (usually takes 30-60 seconds if you create or recreate the container).

Step 5: Verify Installation

If you are running docker compose on something like WSL or your local machine, you should be able to access http://localhost:8081 and see only office is ready.

office

Or check via terminal:

Check OnlyOffice Health:

BASH 
1
2
3
4
5

# Should return {"status":"ok"} or true
curl http://localhost:8081/healthcheck

# Check welcome page
curl http://localhost:8081/welcome

Check FileBrowser:

  1. Open browser and navigate to http://localhost:8080
  2. Login with default credentials (admin/yourpassword)
  3. Upload a test document (could be a .docx, .xlsx, or .pptx)
  4. Click on the document to preview - should open in OnlyOffice editor

You should see something like this:

office-editor

Disable Editing - View Only

In FileBrowser config:

YAML 
1
2
3

integrations:
  office:
    viewOnly: true

Next Steps

Additional Resources