// troubleshooting guide · collabora online

Nextcloud Office Built-in CODE Server Not Working

Status
Workaround available
platforms:
Nextcloud, Linux, Raspberry Pi, Snap
updated:
November 16, 2026
reports:
4
Method
how we research
Share

RUNBOOK · collabora-online/built-in-code-server-not-working4 FIXES

// quick answer

The built-in server needs Nextcloud to reach itself by its public hostname and the right CPU package. Add the domain to /etc/hosts, check the WOPI allow list and install the ARM64 app on ARM.

Most likely fix: Let Nextcloud reach itself

How to fix it

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

  1. FIX 1Let Nextcloud reach itself

    1. 01Make sure the server resolves the hostname you use in the browser
    2. 02If not, add a line to /etc/hosts: 127.0.0.1 cloud.yourdomain.com
    3. 03Reload Administration > Office
    Did this fix it?
  2. FIX 2Add the server IP to the WOPI allow list

    1. 01Open Administration settings > Office
    2. 02Add the server's own IP to 'Allow list for WOPI requests'
    Did this fix it?
  3. FIX 3Install the right package

    1. 01Run uname -m; aarch64 needs 'Collabora Online - Built-in CODE Server (ARM64)'
    2. 02Remove the other variant and enable the matching app
    Did this fix it?
  4. FIX 4Use a separate Collabora container

    1. 01If it still fails or is slow, run Collabora as its own Docker container
    2. 02Point Administration > Office to that server's URL
    Did this fix it?

Symptoms

'Nextcloud Office could not connect to the built-in Collabora Online', documents never load, or Nextcloud gets slow while it keeps retrying the connection.

Why it happens

  • C-01Nextcloud cannot resolve or reach its own hostname
  • C-02WOPI allow list missing the server's IP
  • C-03Wrong package for the CPU (x86 vs ARM64)
  • C-04A bug in a specific richdocumentscode release
  • C-05nginx blocks the richdocumentscode proxy.php path

// this guide also covers

  • nextcloud built-in code server not working
  • nextcloud office could not connect to the built-in collabora online
  • richdocumentscode not working
  • collabora arm64 nextcloud

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

Other Collabora Online errors

All 10 Collabora Online errors and fixes →