// 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
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
FIX 1Test the discovery URL
- 01From Nextcloud run: curl https://office.example.com/hosting/capabilities
- 02And: curl https://office.example.com/hosting/discovery
- 03Open both in the browser too; all must return data
Did this fix it?FIX 2Fix firewall and Docker order
- 01Start Docker after the firewall is running, because Docker edits iptables rules
- 02Open the Collabora port between the servers
Did this fix it?FIX 3Use the same protocol
- 01If Nextcloud is on HTTPS, Collabora must be reachable over HTTPS too
- 02If the proxy terminates SSL, configure Collabora for SSL termination instead of serving SSL itself
Did this fix it?FIX 4Fix internal DNS
- 01Make the Collabora domain resolve to an address Nextcloud can reach (local DNS zone or hosts entry)
- 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 usThe same problem in other apps
All not loading, error messages & connection guides →
ONLYOFFICE 'Document Security Token Is Not Correctly Formed' Error (ONLYOFFICE)
Word Experienced an Error Trying to Open the File (Microsoft Word)
Zoho Writer Reconnecting or Slow Typing (Zoho Writer)
Other Collabora Online errors
- Collabora Document Loading Failed in Nextcloud
- Collabora Unauthorized WOPI Host Error
- Nextcloud Office Built-in CODE Server Not Working
- Collabora 'Socket Connection Could Not Be Established' Error
- Why Is Collabora Online So Slow?
- Collabora Document Cannot Be Saved in Nextcloud
- Collabora Opens Documents Read-Only
- Collabora Online Missing Fonts