Practical, community-tested guides for deploying FileBrowser Quantum with OnlyOffice document server.

Available Guides

Best for: Local development, testing, learning.

Simple HTTP-based setup, perfect for:

  • Getting started with OnlyOffice.
  • Testing on your local machine.
  • Development environments.
  • Internal network deployments.
Start Basic Setup →

What you’ll learn:

  • Generate JWT secrets.
  • Configure Docker Compose.
  • Set up FileBrowser and OnlyOffice.
  • Test document editing.

Time: 15-20 minutes

Best for: Production deployments, internet-facing servers.

Production-ready setup with automatic HTTPS:

  • Let’s Encrypt SSL certificates.
  • Automatic certificate renewal.
  • Secure JWT authentication.
  • DDNS support (Dynu, Cloudflare, DuckDNS, etc).
Start Traefik Setup →

What you’ll learn:

  • All from the Basic Docker Setup.
  • Configure and deploy Traefik for your services and configure them with docker compose.
  • Set up static IPs for containers.
  • How to configure and use traefik for your services.
  • Secure production deployment.

Time: 45-60 minutes

3. Internal HTTPS Office configuration

Best for: Advanced users, custom security requirements

Advanced HTTPS configurations for special needs:

  • Onlyoffice with Internal HTTPS communication.
  • Self-signed and custom CA certificates.
  • Optional Full office certificate velidation.
Start internal office HTTPS Setup →

What you’ll learn:

  • All from Traefik Setup Guide
  • Generate self-signed certificates.
  • Set up static IPs for containers.

Time: 60-90 minutes

Quick Decision Matrix

ScenarioRecommended Guide
“I want to try OnlyOffice quickly”Basic Docker Setup
“I need production deployment with HTTPS”Traefik Setup
“I’m deploying on internal network only”Basic Docker Setup
“I need custom CA certificates”Internal office HTTPS
“I want automatic SSL renewal”Traefik Setup
“I need internal HTTPS communication”Internal Office HTTPS

Prerequisites for All Guides

Before starting any guide, ensure you have:

  • ✅ Docker installed (version 20.10+).
  • ✅ Docker Compose installed (version 2.0+).
  • ✅ Basic terminal/command line knowledge.
  • ✅ Text editor for configuration files.
  • ✅ At least 4GB RAM available (2GB for OnlyOffice minimum).
  • ✅ 10GB disk space for Docker images.

For production guides, additionally:

  • ✅ Domain name registered.
  • ✅ DDNS provider account (Dynu, Cloudflare, DuckDNS, etc).
  • ✅ Email address for Let’s Encrypt.

What is OnlyOffice?

OnlyOffice is a powerful open-source office suite that provides:

  • Document editing: Word, Excel, PowerPoint-like functionality
  • Collaborative editing: Multiple users editing simultaneously
  • Format support: .docx, .xlsx, .pptx, .odt, .pdf, and more
  • Web-based: No software installation for end users
  • Self-hosted: Full control over your data
Learn more about OnlyOffice →

Integration Architecture

Here’s how FileBrowser Quantum integrates with OnlyOffice:

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

┌─────────────────┐
│   Browser       │
│  (You)          │
└────────┬────────┘
         │ HTTPS
         ↓
┌─────────────────┐
│   Traefik       │ ← Manages SSL/TLS
│  (Reverse Proxy)│ ← Routes traffic
└────────┬────────┘
         │
    ┌────┴─────┐
    ↓          ↓
┌─────────┐ ┌──────────────┐
│FileBrowser│ │  OnlyOffice  │
│ Quantum │←→│Document Server│
└─────────┘ └──────────────┘
    │              │
    ↓              ↓
┌─────────┐    ┌──────┐
│  Files  │    │Cache │
└─────────┘    └──────┘

Flow:

  1. User clicks document in FileBrowser
  2. FileBrowser requests OnlyOffice config
  3. OnlyOffice downloads document from FileBrowser
  4. User edits in OnlyOffice editor
  5. OnlyOffice saves changes back to FileBrowser
See detailed troubleshooting diagram →

After Setup

Once you’ve completed a guide:

Enable Features

User Settings:

  • Configure which file types open in OnlyOffice
  • Enable/disable debug mode
  • Set view-only defaults

Admin Settings:

  • Configure server-level OnlyOffice options
  • Set default permissions
  • Customize UI behavior

Test Integration

  1. Upload test documents - Try .docx, .xlsx, .pptx
  2. Edit documents - Make changes and verify saves
  3. Test collaborative editing - Multiple users editing simultaneously
  4. Check preview support - Verify document previews work
  5. Enable debug mode - Troubleshoot if needed

Monitor Health

BASH 
1
2
3
4
5
6
7
8
9

# Check OnlyOffice health
curl https://office.yourdomain.com/healthcheck

# View logs
docker logs -f onlyoffice
docker logs -f filebrowser

# Check resource usage
docker stats

Community Contributions

These guides are based on configurations shared by FileBrowser community members:

Want to contribute your configuration? Share it in GitHub Discussions!

Additional Resources

Documentation

External Resources

Community

Getting Help

If you encounter issues:

  1. Enable debug mode in FileBrowser profile settings.
  2. Check troubleshooting guide for common solutions.
  3. Review logs from both FileBrowser and OnlyOffice.
  4. Search existing issues on GitHub.
  5. Ask in discussions with your configuration details.
Go to Troubleshooting →

Ready to Start?

Choose your guide and begin setting up OnlyOffice integration:

🚀 Basic Setup

Quick HTTP setup for local testing

Start Guide →

⭐ Production Setup

Behind Traefik Reverse-proxy

Start Guide →

🔒 Internal office HTTPS

Custom certificates

Start Guide →