// troubleshooting guide · collabora online

Collabora Document Loading Failed in Nextcloud

Status
Workaround available
platforms:
Nextcloud, Docker, Linux
updated:
November 16, 2026
reports:
6
Method
how we research
Share

RUNBOOK · collabora-online/document-loading-failed4 FIXES

// quick answer

Collabora cannot fetch the file back from Nextcloud over WOPI. Check the Collabora log for WOPI::CheckFileInfo errors, then fix connectivity, DNS or the allow list between the two servers.

Most likely fix: Read the Collabora log first

How to fix it

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

  1. FIX 1Read the Collabora log first

    1. 01Docker: run docker logs <collabora-container>
    2. 02Look for WOPI::CheckFileInfo failed, Access denied 403 or Unauthorized WOPI host
    3. 03The first error tells you which direction of the connection is broken
    Did this fix it?
  2. FIX 2Test both directions with curl

    1. 01From the Nextcloud server: curl https://office.example.com/hosting/discovery
    2. 02From the Collabora server or container: curl https://nextcloud.example.com/status.php
    3. 03If the second fails, fix DNS (an /etc/hosts or extra_hosts entry for the Nextcloud domain) or the firewall
    Did this fix it?
  3. FIX 3Check the WOPI allow list

    1. 01In Nextcloud open Administration settings > Office
    2. 02Add the IP Collabora connects from to 'Allow list for WOPI requests'
    3. 03To confirm the diagnosis only, test with a wide range, then narrow it again
    Did this fix it?
  4. FIX 4Check the browser network console

    1. 01Open developer tools > Network and reload the document
    2. 02Look for failed wss:// or /cool/ requests, which point to the reverse proxy
    Did this fix it?

Symptoms

The editor spins and shows 'Document loading failed', 'Failed to load Nextcloud Office - please try again later' or 'Failed to read document from storage', even though Office settings say the server is reachable.

Why it happens

  • C-01Collabora cannot reach Nextcloud by its public hostname (Docker, hairpin NAT, internal DNS)
  • C-02WOPI allow list blocks Collabora's IP (403 / Unauthorized WOPI host)
  • C-03Reverse proxy does not forward WebSockets
  • C-04HTTP/HTTPS mismatch or untrusted certificate
  • C-05Collabora version incompatible with the Nextcloud version

// this guide also covers

  • collabora document loading failed
  • failed to load nextcloud office
  • collabora not loading nextcloud
  • collabora failed to read document from storage

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 →