Overview of office document preview and editing capabilities.

Overview

FileBrowser Quantum integrates with OnlyOffice Document Server to provide document preview and editing capabilities directly in the browser.

Support Levels

Without Integration (Default)

  • Image preview for certain formats
  • Basic DOCX and EPUB viewer

With OnlyOffice Integration

  • Wide range of preview types
  • Full office editor
  • Real-time collaboration

Features

  • ✅ Open and edit office documents
  • ✅ Enable/disable OnlyOffice per user
  • ✅ Create new files from UI
  • ✅ Office document previews
  • ✅ Real-time collaboration
  • ✅ Share office files with editing

Supported File Types

Word Processing

TEXT 
1
2

.doc, .docm, .docx, .dot, .dotm, .dotx, .epub, .fb2, .fodt, .htm, .html,
.mht, .mhtml, .odt, .ott, .rtf, .stw, .sxw, .txt, .wps, .wpt, .xml

Spreadsheets

TEXT 
1
2

.csv, .et, .ett, .fods, .ods, .ots, .sxc, .xls, .xlsb, .xlsm, .xlsx,
.xlt, .xltm, .xltx

Presentations

TEXT 
1
2

.dps, .dpt, .fodp, .odp, .otp, .pot, .potm, .potx, .pps, .ppsm, .ppsx,
.ppt, .pptm, .pptx, .sxi

Other Formats

TEXT 
1

.djvu, .docxf, .oform, .oxps, .pdf, .xps

Native Preview Support

Without OnlyOffice, these formats have native preview:

TEXT 
1
2

.pdf, .xps, .epub, .mobi, .fb2, .cbz, .svg, .txt, .docx, .ppt, .pptx,
.xlsx, .hwp, .hwpx

Configuration

To enable these office features, you need:

  1. A running OnlyOffice server accessible from both server and client
  2. Update config.yaml to add the integration with URL and JWT secret

Basic Configuration

YAML 
1
2
3
4

integrations:
  office:
    url: "http://onlyoffice-server:8000"  # OnlyOffice Document Server URL
    secret: "your-secret-key"             # Optional JWT secret for security

Server Settings

YAML 
1
2
3

server:
  baseURL: "/filebrowser"                 # Base URL for external access
  internalUrl: "http://filebrowser:8080"  # (Optional) internal URL for filebrowser so other services like onlyoffice can communicate directly

Troubleshooting

see Troubleshooting

Common Configuration Issues

1. Docker Network Setup

If using Docker, ensure services can communicate:

YAML 
1
2
3
4
5
6
7
8
9

# docker-compose.yml
services:
  filebrowser:
    image: filebrowser/filebrowser
    environment:
      - INTERNAL_URL=http://filebrowser:8080

  onlyoffice:
    image: onlyoffice/documentserver

2. Reverse Proxy Configuration

When using a reverse proxy, ensure proper headers:

NGINX 
1
2
3
4
5
6
7
8

# nginx.conf
location /onlyoffice/ {
    proxy_pass http://onlyoffice:8000/;
    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;
}

Status Codes Reference

OnlyOffice Callback Status Codes

  • 1: Document being edited
  • 2: Document ready for saving (closed with changes)
  • 3: Document saving error
  • 4: Document closed without changes
  • 6: Document being edited, but force save requested
  • 7: Document error

HTTP Response Codes

  • 200: Success
  • 400: Bad request (missing parameters, invalid format)
  • 403: Forbidden (no access to source, no modify permissions)
  • 404: Not found (file not found, document ID generation failed)
  • 500: Internal server error (configuration issues, system errors)

Next Steps