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, etc.)
Start Traefik Setup →

What you’ll learn:

  • Configure Traefik reverse proxy
  • Set up automatic HTTPS
  • Deploy with Docker labels
  • Secure production deployment

Time: 45-60 minutes

3. Advanced HTTPS Configuration

Best for: Advanced users, custom security requirements

Advanced HTTPS configurations for special needs:

  • Self-signed certificates
  • Custom CA certificates
  • Full certificate verification
  • Multiple verification methods
Start Advanced Setup →

What you’ll learn:

  • Generate self-signed certificates
  • Configure Traefik file providers
  • Set up static IPs for containers
  • Implement full certificate validation

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 with Labels
“I’m deploying on internal network only”Basic Docker Setup
“I need custom CA certificates”Advanced HTTPS
“I want automatic SSL renewal”Traefik with Labels
“I have specific security requirements”Advanced 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, etc.)
  • DNS configured and propagated
  • Email address for Let’s Encrypt notifications

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:

┌─────────────────┐
│   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 

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

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

# Check resource usage
docker stats

Community Contributions

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

  • @Kurami32 - Complete Traefik setup with Let’s Encrypt
  • @BaccanoMob - Advanced HTTPS methods and troubleshooting

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

Traefik with automatic HTTPS

Start Guide →

🔒 Advanced HTTPS

Custom certificates and security

Start Guide →