// 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
Share

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

  1. FIX 1Check the connector settings

    1. 01In Nextcloud open Administration settings > ONLYOFFICE
    2. 02Enter the Document Server address and the same secret key as on the server
    3. 03Save and read the error text shown
    Did this fix it?
  2. FIX 2Allow local addresses

    1. 01Run: php occ config:system:set allow_local_remote_servers --value true --type bool
    2. 02Retry the connection
    Did this fix it?
  3. FIX 3Fix HTTPS and certificates

    1. 01If Nextcloud uses HTTPS, give the Document Server an HTTPS address
    2. 02Use a certificate trusted by both servers or install the CA in PHP's trust store
    3. 03As a test only, tick Disable certificate verification
    Did this fix it?
  4. FIX 4Read the Document Server logs

    1. 01Linux package: /var/log/onlyoffice/documentserver/
    2. 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 us

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

Fixed it? Share this guide

Other ONLYOFFICE errors