// troubleshooting guide · onlyoffice
ONLYOFFICE Not Working in Nextcloud
- Status
- Workaround available
- platforms:
- Nextcloud, Docker, Linux
- updated:
- November 16, 2026
- reports:
- 5
- Method
- how we research
RUNBOOK · onlyoffice/nextcloud-not-working4 FIXES
// quick answer
Nextcloud cannot reach the Document Server, usually a wrong address, JWT secret, certificate or local-access block. Fix the connector settings first.
Most likely fix: Check the connector settings
How to fix it
// try these in order, the most common fix is first
FIX 1Check the connector settings
- 01In Nextcloud open Administration settings > ONLYOFFICE
- 02Enter the Document Server address and the same secret key as on the server
- 03Save and read the error text shown
Did this fix it?FIX 2Allow local addresses
- 01Run: php occ config:system:set allow_local_remote_servers --value true --type bool
- 02Retry the connection
Did this fix it?FIX 3Fix HTTPS and certificates
- 01If Nextcloud uses HTTPS, give the Document Server an HTTPS address
- 02Use a certificate trusted by both servers or install the CA in PHP's trust store
- 03As a test only, tick Disable certificate verification
Did this fix it?FIX 4Read the Document Server logs
- 01Linux package: /var/log/onlyoffice/documentserver/
- 02Docker: /app/onlyoffice/DocumentServer/logs/documentserver/
Did this fix it?
Symptoms
Opening a document in Nextcloud shows 'Error when trying to connect' or the editor never loads.
Why it happens
- C-01Wrong Document Server or internal address
- C-02JWT secret mismatch
- C-03Self-signed or untrusted certificate
- C-04Nextcloud blocks local servers ('host violates local access rules')
- C-05HTTP/HTTPS mismatch (mixed content)
// this guide also covers
- onlyoffice not working nextcloud
- onlyoffice nextcloud error when trying to connect
Still not working?
If ONLYOFFICE keeps failing, you're not alone. See every ONLYOFFICE 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 usOther ONLYOFFICE errors
- ONLYOFFICE 'Document Security Token Is Not Correctly Formed' Error
- ONLYOFFICE 'Error While Downloading the Document File to Be Converted'
- ONLYOFFICE Not Loading After Docker Update
- ONLYOFFICE Desktop Editors Crash or Won't Start
- Why Is ONLYOFFICE So Slow?
- ONLYOFFICE Fonts Not Showing or Missing
- ONLYOFFICE DOCX Formatting Changes or Won't Open in Word
- ONLYOFFICE Community Edition 20 Connection Limit