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

Quick Start

Step 1: Generate JWT Secret

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

# Method 1: Using OpenSSL
openssl rand -base64 32

# Example output:
# TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue

Step 2: Create Docker Compose File

Create a docker-compose.yml file:

services:
  filebrowser:
    image: gtstef/filebrowser:latest
    ports:
      - "8080:80"
    volumes:
      - ./data:/home/filebrowser/data
    restart: unless-stopped

  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice
    ports:
      - "80:80"
    environment:
      - JWT_ENABLED=true
      - JWT_SECRET=TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue  # Replace with your secret
      - JWT_HEADER=Authorization
    restart: unless-stopped

Step 3: Create FileBrowser Configuration

Create a config.yaml file in the same directory:

server:
  port: 80
  sources:
    - name: "files"
      path: "/srv"
      config:
        defaultEnabled: true

integrations:
  office:
    url: "http://localhost"  # OnlyOffice accessible from browser
    secret: "TevrjpRNMmKC0JxAwY7iZ2VXLrvG1gue"  # Same secret as OnlyOffice
    viewOnly: false

Step 4: Start Services 

# Start services in background
docker-compose up -d

Wait for OnlyOffice to fully start (takes 30-60 seconds on first run).

Step 5: Verify Installation

Check OnlyOffice Health:

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

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

Check FileBrowser:

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

Disable Editing for Specific Users

In FileBrowser user settings or config:

integrations:
  office:
    viewOnly: true

Next Steps

Additional Resources