// troubleshooting guide · collabora online
Collabora 'Socket Connection Could Not Be Established' Error
- Status
- Workaround available
- platforms:
- nginx, Apache, Traefik, Plesk, Docker
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · collabora-online/socket-connection-error3 FIXES
// quick answer
Your reverse proxy isn't passing WebSockets to Collabora. Add a WebSocket location with Upgrade headers for /cool/.../ws and raise proxy timeouts.
Most likely fix: Add the WebSocket location (nginx)
How to fix it
// try these in order, the most common fix is first
FIX 1Add the WebSocket location (nginx)
- 01Add a location for /cool/(.*)/ws with proxy_set_header Upgrade $http_upgrade and Connection "Upgrade"
- 02Add the same for /cool/adminws (admin console)
- 03Keep proxy_pass as an http:// address to port 9980; nginx rejects ws:// there
Did this fix it?FIX 2Raise timeouts
- 01Set a long proxy_read_timeout on the WebSocket location (forum examples use 36000s)
- 02Reload nginx and reopen the document
Did this fix it?FIX 3Avoid double SSL
- 01If the proxy terminates SSL, turn SSL off in Collabora's config (coolwsd.xml) and enable SSL termination
- 02Restart Collabora
Did this fix it?
Symptoms
'The socket connection could not be established or was unexpectedly closed. The reverse proxy might be misconfigured.' The document may open and then disconnect.
Why it happens
- C-01No Upgrade / Connection headers for the WebSocket path
- C-02Collabora served under a subpath that isn't mapped back to /cool/
- C-03Short proxy read timeouts
- C-04SSL terminated twice (proxy and Collabora)
// this guide also covers
- collabora socket connection could not be established
- collabora reverse proxy might be misconfigured
- collabora websocket nginx
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
- Could Not Establish Connection to the Collabora Online Server
- Nextcloud Office Built-in CODE Server Not Working
- Why Is Collabora Online So Slow?
- Collabora Document Cannot Be Saved in Nextcloud
- Collabora Opens Documents Read-Only
- Collabora Online Missing Fonts