// troubleshooting guide · collabora online

Could Not Establish Connection to the Collabora Online Server

Status
Workaround available
platforms:
Nextcloud, Docker, Cloudron, Plesk
updated:
November 16, 2026
reports:
5
Method
how we research
Share

RUNBOOK · collabora-online/could-not-establish-connection4 FIXES

// quick answer

Nextcloud cannot reach Collabora. Verify the discovery URL with curl, check the firewall and Docker start order, and make sure both servers use the same protocol.

Most likely fix: Test the discovery URL

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Test the discovery URL

    1. 01From Nextcloud run: curl https://office.example.com/hosting/capabilities
    2. 02And: curl https://office.example.com/hosting/discovery
    3. 03Open both in the browser too; all must return data
    Did this fix it?
  2. FIX 2Fix firewall and Docker order

    1. 01Start Docker after the firewall is running, because Docker edits iptables rules
    2. 02Open the Collabora port between the servers
    Did this fix it?
  3. FIX 3Use the same protocol

    1. 01If Nextcloud is on HTTPS, Collabora must be reachable over HTTPS too
    2. 02If the proxy terminates SSL, configure Collabora for SSL termination instead of serving SSL itself
    Did this fix it?
  4. FIX 4Fix internal DNS

    1. 01Make the Collabora domain resolve to an address Nextcloud can reach (local DNS zone or hosts entry)
    2. 02Retry saving the Office settings
    Did this fix it?

Symptoms

Administration > Office shows 'Could not establish connection to the Collabora Online server' and documents won't open.

Why it happens

  • C-01Firewall blocks the connection, or Docker started before the firewall
  • C-02HTTP vs HTTPS mismatch between Nextcloud and Collabora
  • C-03Internal DNS resolves the domain to an unreachable address
  • C-04nginx missing the location for the richdocumentscode proxy

// this guide also covers

  • could not establish connection to the collabora online server
  • collabora online server is not reachable
  • nextcloud office cannot connect to collabora

Still not working?

If Collabora Online keeps failing, you're not alone. See every Collabora Online problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Collabora Online Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Collabora Online errors

All 10 Collabora Online errors and fixes →