Cubby & Collabora integration

[luckow]

Cubby <-> Collabora on different instances.

Any idea what this console error means?

Firefox kann keine Verbindung zu dem Server unter wss://collabora.example.org/cool/https%3A%2F%2Fcubby.example.com%2Fapi%2Fv1%2Foffice%2Fwopi%2Ffiles%2Fhid-5b95502b9786ed3ba72f8e882b08cf4133db7c7c2cfb7c321e5cf0391a111e1b%3Faccess_token%3D9960178323b43261501c591b7f1ff6ed0fae9611add6d64935e087c1ceb49013%26access_token_ttl%3D0%26permission%3Dedit/ws?WOPISrc=https%3A%2F%2Fcubby.example.com%%2Fapi%2Fv1%2Foffice%2Fwopi%2Ffiles%2Fhid-5b95502b9786ed3ba72f8e882b08cf4133db7c7c2cfb7c321e5cf0391a111e1b&compat=/ws aufbauen. global.js:1:38362
Die Verbindung zu wss://collabora.example.org/cool/https%3A%2F%2Fcubby.example.com%%2Fapi%2Fv1%2Foffice%2Fwopi%2Ffiles%2Fhid-5b95502b9786ed3ba72f8e882b08cf4133db7c7c2cfb7c321e5cf0391a111e1b%3Faccess_token%3D9960178323b43261501c591b7f1ff6ed0fae9611add6d64935e087c1ceb49013%26access_token_ttl%3D0%26permission%3Dedit/ws?WOPISrc=https%3A%2F%2Fcubby.example.com%%2Fapi%2Fv1%2Foffice%2Fwopi%2Ffiles%2Fhid-5b95502b9786ed3ba72f8e882b08cf4133db7c7c2cfb7c321e5cf0391a111e1b&compat=/ws wurde unterbrochen, während die Seite geladen wurde.

[nebulon]

Do you see any blocked requests or other errors in the browser network tab while trying to open a document? Assuming you see this error while opening a document.

Also anything in either app logs?

[luckow]

@nebulon User error confirmed after 15 minutes of testing. Note: adding another domain to Collabora requires the format [a-zA-Z0-9_\-.]*domain1.org|[a-zA-Z0-9_\-.]*domain2.org plus a restart. We should probably update the settings page with this info.

[nebulon]

The required restart is a good hint which the UI should give. We will add this.

[nebulon]

After debugging this, turns out the internal app restart was broken, hence it required a whole app restart. This is fixed with next package version.

[hakunamatata]

I think I may have stumbled upon the issue on my end. I have Collabora running behind Cloudflare's proxy.

When attempting to open files with spaces in their filenames via Collabora, Cubby fails to load the document and returns a 404 Not Found in the browser console. This appears to be caused by double-encoding of the file path in the WOPI handshake.

Steps to Reproduce:

1. Upload a file with a space in the name (e.g., Audit Record 2026.xlsx) to Cubby.

2. Attempt to open the file with the Collabora integration.

3. The editor opens but remains blank.

Observed Behavior:
The browser console shows a 404 error for the file path:
api/v1/files?path=%2Fhome%2F2025-11-19%2520Work%2520Orders.xlsx
The space character (%20) has been double-encoded into %2520.

Expected Behavior:
The path should be decoded correctly by the server/proxy to locate the file on disk.

Workaround Found:
Renaming the file to remove spaces (e.g., Audit_Record_2026.xlsx) resolves the issue and the file opens successfully.

Possible Solution:
Cloudron team can fix this by changing how the app handles the WOPI access_token or by ensuring the path is decoded once more before the final request.

[joseph]

What if the filename has 2 spaces? Does this become 4 spaces in encoding? How is cubby supposed to know when to double decode? Do you have link for this cloudflare encoding behavior?

[hakunamatata]

Encoding is per-character, so it doesn't multiply the number of spaces; it just makes the string significantly longer.

1 Space: → %20 (Single) → %2520 (Double)

2 Spaces: → %20%20 (Single) → %2520%2520 (Double)

It doesn't become 4 spaces, but it becomes a very "noisy" URL.

You can find the official explanation of how Cloudflare handles this here: https://developers.cloudflare.com/rules/normalization/

In theory, if I turn this behaviour off in Cloudflare's settings, then Cubby should be able to talk with Collabora without any issues. I will test this out later when I have some time.

But I think there is probably a way to get this fixed within Cubby itself because on NextCloud it works fine.

One difference I have noticed between Cubby's implementation vs Nextcloud's is that when Nextcloud talks to Collabora, it doesn't usually send the filename in the URL. It uses an Internal File ID (e.g.,/files/12345). Because the URL only contains numbers, there are no spaces to encode, so Cloudflare has nothing to double-encode. Cubby on the other hand passes the Literal Path as a query parameter (?path=/home/File Name.xlsx). Because the filename itself is in the URL, the spaces are exposed to Cloudflare’s "normalization" logic. So that might be an area to explore.

[nebulon]

So yes also cubby communicates via unique file handles with collabora. So that isn't the issue. But there is an issue in the cubby outer frame loading collabora. Trying to get this fixed....

[nebulon]

This is fixed with latest package version. I will lock this thread as it seems to collect different issues. Please open a new thread in the cubby category for new collabora issues with cubby.