// troubleshooting guide · collabora online

Collabora Unauthorized WOPI Host Error

Status
Workaround available
platforms:
Nextcloud, Docker, TrueNAS, Nextcloud AIO
updated:
November 16, 2026
reports:
5
Method
how we research
Share

RUNBOOK · collabora-online/unauthorized-wopi-host3 FIXES

// quick answer

The request came from a host that isn't allowed. Start Collabora with your Nextcloud URL and add the address Collabora calls from to Nextcloud's WOPI allow list.

Most likely fix: Start Collabora with the Nextcloud URL

How to fix it

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

  1. FIX 1Start Collabora with the Nextcloud URL

    1. 01Recreate the Collabora container with the aliasgroup1 variable set to your Nextcloud address (for example https://nextcloud.example.com:443)
    2. 02Do not use the Collabora server's own address there
    3. 03Restart and check docker logs for the WOPI host message
    Did this fix it?
  2. FIX 2Fix the allow list in Nextcloud

    1. 01Open Administration settings > Office
    2. 02Add the public or Docker-network IP of the Collabora server to 'Allow list for WOPI requests'
    3. 03Check the Nextcloud log to see which IP the WOPI requests actually come from
    Did this fix it?
  3. FIX 3Behind Cloudflare or a proxy

    1. 01Requests may come from proxy IPs, not Collabora's
    2. 02Route Collabora to Nextcloud directly (internal DNS or extra_hosts) so the real IP is used
    Did this fix it?

Symptoms

Opening a document shows 'Unauthorized WOPI host. Please try again later and report to your administrator if the issue persists.' The Collabora log may show 'No acceptable WOPI hosts found matching the target host'.

Why it happens

  • C-01Docker container started with the Collabora URL instead of the Nextcloud URL
  • C-02Nextcloud's WOPI allow list does not include Collabora's real IP
  • C-03Requests arrive through Cloudflare or a proxy with a different IP
  • C-04Host not allowed in Collabora's own configuration

// this guide also covers

  • unauthorized wopi host
  • collabora unauthorized wopi host
  • no acceptable wopi hosts found matching the target host
  • nextcloud wopi allow list

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 →