// 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
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
FIX 1Let Nextcloud reach itself
- 01Make sure the server resolves the hostname you use in the browser
- 02If not, add a line to /etc/hosts: 127.0.0.1 cloud.yourdomain.com
- 03Reload Administration > Office
Did this fix it?FIX 2Add the server IP to the WOPI allow list
- 01Open Administration settings > Office
- 02Add the server's own IP to 'Allow list for WOPI requests'
Did this fix it?FIX 3Install the right package
- 01Run uname -m; aarch64 needs 'Collabora Online - Built-in CODE Server (ARM64)'
- 02Remove the other variant and enable the matching app
Did this fix it?FIX 4Use a separate Collabora container
- 01If it still fails or is slow, run Collabora as its own Docker container
- 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 usOther Collabora Online errors
- Collabora Document Loading Failed in Nextcloud
- Collabora Unauthorized WOPI Host Error
- Could Not Establish Connection to the Collabora Online Server
- Collabora 'Socket Connection Could Not Be Established' Error
- Why Is Collabora Online So Slow?
- Collabora Document Cannot Be Saved in Nextcloud
- Collabora Opens Documents Read-Only
- Collabora Online Missing Fonts