Upgrading Nextcloud causes Whiteboard files to no longer open

[nooblag]

Upon upgrade to 31.x, prior .whiteboard files no longer open in app editor, they default to download.

Ubuntu 22.04.5 LTS
nginx version: nginx/1.18.0 (Ubuntu)
PHP 8.3.29 (cli) (built: Dec 18 2025 23:37:38) (NTS)
psql (PostgreSQL) 17.7 (Ubuntu 17.7-3.pgdg22.04+1)

config.php:

Details

{
    "system": {
        "passwordsalt": "***REMOVED SENSITIVE VALUE***",
        "secret": "***REMOVED SENSITIVE VALUE***",
        "trusted_domains": [
            "***REMOVED SENSITIVE VALUE***",
            "***REMOVED SENSITIVE VALUE***"
        ],
        "datadirectory": "***REMOVED SENSITIVE VALUE***",
        "tempdirectory": "***REMOVED SENSITIVE VALUE***/temp",
        "skeletondirectory": "***REMOVED SENSITIVE VALUE***/skeleton",
        "templatedirectory": "***REMOVED SENSITIVE VALUE***/templates",
        "updatedirectory": "***REMOVED SENSITIVE VALUE***/update",
        "dbtype": "pgsql",
        "version": "31.0.13.1",
        "overwrite.cli.url": "***REMOVED SENSITIVE VALUE***",
        "htaccess.RewriteBase": "\/",
        "dbname": "***REMOVED SENSITIVE VALUE***",
        "dbhost": "***REMOVED SENSITIVE VALUE***",
        "dbport": "***REMOVED SENSITIVE VALUE***",
        "dbtableprefix": "oc_",
        "dbuser": "***REMOVED SENSITIVE VALUE***",
        "dbpassword": "***REMOVED SENSITIVE VALUE***",
        "installed": true,
        "instanceid": "***REMOVED SENSITIVE VALUE***",
        "log_type": "file",
        "logfile": "\/var\/log\/nextcloud\/nextcloud.log",
        "loglevel": 3,
        "logtimezone": "Australia\/Melbourne",
        "maintenance_window_start": 1,
        "mail_smtpmode": "smtp",
        "remember_login_cookie_lifetime": 0,
        "log_rotate_size": "10485760",
        "trashbin_retention_obligation": "auto, 14",
        "versions_retention_obligation": "auto, 365",
        "simpleSignUpLink.shown": false,
        "login_form_autocomplete": true,
        "filelocking.enabled": true,
        "memcache.distributed": "\\OC\\Memcache\\Redis",
        "memcache.local": "\\OC\\Memcache\\Redis",
        "memcache.locking": "\\OC\\Memcache\\Redis",
        "redis": {
            "host": "***REMOVED SENSITIVE VALUE***",
            "port": "***REMOVED SENSITIVE VALUE***",
            "dbindex": "0",
            "timeout": "1.5"
        },
        "maintenance": false,
        "default_phone_region": "AU",
        "default_locale": "en_AU",
        "force_locale": "en_AU",
        "default_language": "en",
        "force_language": "en",
        "defaultapp": "activity,files",
        "activity_expire_days": 180,
        "session_lifetime": 14400,
        "session_keepalive": false,
        "auth.webauthn.enabled": false,
        "overwriteprotocol": "https",
        "updater.release.channel": "stable",
        "theme": "",
        "connectivity_check_domains": [
            "***REMOVED SENSITIVE VALUE***",
            "***REMOVED SENSITIVE VALUE***"
        ],
        "trusted_proxies": "***REMOVED SENSITIVE VALUE***",
        "forwarded_for_headers": [
            "HTTP_CF_CONNECTING_IP"
        ],
        "mail_smtpsecure": "ssl",
        "mail_sendmailmode": "smtp",
        "mail_from_address": "***REMOVED SENSITIVE VALUE***",
        "mail_domain": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpauthtype": "LOGIN",
        "mail_smtpauth": true,
        "mail_smtpport": "***REMOVED SENSITIVE VALUE***",
        "mail_smtpname": "***REMOVED SENSITIVE VALUE***",
        "mail_smtppassword": "***REMOVED SENSITIVE VALUE***",
        "enable_previews": true,
        "enabledPreviewProviders": [
            "OC\\Preview\\BMP",
            "OC\\Preview\\GIF",
            "OC\\Preview\\JPEG",
            "OC\\Preview\\Krita",
            "OC\\Preview\\MarkDown",
            "OC\\Preview\\MP3",
            "OC\\Preview\\OpenDocument",
            "OC\\Preview\\PNG",
            "OC\\Preview\\TXT",
            "OC\\Preview\\XBitmap",
            "OC\\Preview\\EMF",
            "OC\\Preview\\MSOfficeDoc",
            "OC\\Preview\\MSOffice2003",
            "OC\\Preview\\MSOffice2007",
            "OC\\Preview\\HEIC",
            "OC\\Preview\\Movie",
            "OC\\Preview\\PDF"
        ],
        "app_install_overwrite": [
            "files_readmemd"
        ],
        "forbidden_filename_basenames": [
            "con",
            "prn",
            "aux",
            "nul",
            "com0",
            "com1",
            "com2",
            "com3",
            "com4",
            "com5",
            "com6",
            "com7",
            "com8",
            "com9",
            "com\u00b9",
            "com\u00b2",
            "com\u00b3",
            "lpt0",
            "lpt1",
            "lpt2",
            "lpt3",
            "lpt4",
            "lpt5",
            "lpt6",
            "lpt7",
            "lpt8",
            "lpt9",
            "lpt\u00b9",
            "lpt\u00b2",
            "lpt\u00b3"
        ],
        "forbidden_filename_characters": [
            "<",
            ">",
            ":",
            "\"",
            "|",
            "?",
            "*",
            "\\",
            "\/"
        ],
        "forbidden_filename_extensions": [
            " ",
            ".",
            ".filepart",
            ".part"
        ],
        "mail_smtphost": "***REMOVED SENSITIVE VALUE***"
    }
}

nextcloud apps:

Details

Enabled:
  - activity: 4.0.0
  - admin_audit: 1.21.0
  - announcementcenter: 7.2.2
  - bruteforcesettings: 4.0.0
  - calendar: 5.5.13
  - camerarawpreviews: 0.8.8
  - checksum: 2.0.3
  - cloud_federation_api: 1.14.0
  - comments: 1.21.0
  - contactsinteraction: 1.12.1
  - dav: 1.33.0
  - deck: 1.15.6
  - drawio: 3.1.2
  - event_update_notification: 2.7.0
  - external: 6.0.2
  - federatedfilesharing: 1.21.0
  - files: 2.3.1
  - files_automatedtagging: 2.0.2
  - files_downloadactivity: 1.18.1
  - files_downloadlimit: 4.0.0
  - files_linkeditor: 1.1.23
  - files_pdfviewer: 4.0.0
  - files_reminders: 1.4.0
  - files_retention: 2.0.1
  - files_sharing: 1.23.2
  - files_trashbin: 1.21.0
  - files_versions: 1.24.0
  - firstrunwizard: 4.0.0
  - forms: 5.2.3
  - groupfolders: 19.1.13
  - imageconverter: 2.0.5
  - impersonate: 2.0.1
  - logreader: 4.0.0
  - lookup_server_connector: 1.19.0
  - metadata: 0.23.0
  - notes: 4.12.4
  - notifications: 4.0.0
  - oauth2: 1.19.1
  - password_policy: 3.0.0
  - passwords: 2025.12.11
  - photos: 4.0.0
  - polls: 8.6.2
  - previewgenerator: 5.11.0
  - privacy: 3.0.0
  - profile: 1.0.0
  - provisioning_api: 1.21.0
  - quota_warning: 1.22.0
  - recommendations: 4.0.0
  - related_resources: 2.0.0
  - richdocuments: 8.7.7
  - serverinfo: 3.0.0
  - settings: 1.14.0
  - sharebymail: 1.21.0
  - systemtags: 1.21.1
  - tasks: 0.17.1
  - text: 5.0.2
  - theming: 2.6.1
  - theming_customcss: 1.19.0
  - twofactor_backupcodes: 1.20.0
  - twofactor_totp: 13.0.0-dev.0
  - updatenotification: 1.21.0
  - viewer: 4.0.0
  - webhook_listeners: 1.2.0
  - whiteboard: 1.5.2
  - workflow_media_converter: 1.15.1
  - workflow_ocr: 1.31.3
  - workflowengine: 2.13.0
Disabled:
  - app_api: 5.0.2 (installed 5.0.2)
  - circles: 31.0.0 (installed 27.0.1)
  - dashboard: 7.11.0 (installed 7.0.0)
  - encryption: 2.19.0
  - federation: 1.21.0 (installed 1.8.0)
  - files_external: 1.23.0 (installed 1.9.0)
  - files_readmemd: 3.0.2 (installed 3.0.2)
  - nextcloud_announcements: 3.0.0 (installed 1.7.0)
  - support: 3.0.0 (installed 1.1.0)
  - survey_client: 3.0.0 (installed 1.6.0)
  - suspicious_login: 9.0.1 (installed 3.2.1)
  - twofactor_nextcloud_notification: 5.0.0
  - user_ldap: 1.22.0
  - user_status: 1.11.0 (installed 1.6.0)
  - weather_status: 1.11.0 (installed 1.0.0)

Nothing in Nextcloud log or Browser console log.

Tried occ maintenance:mimetype:update-db --repair-filecache but that unforch didn't fix.

[juliusknorr]

We did not see this happening on other instances. Can you tell if the whiteboard server is up and running and showing up as connected in the settings?

If the file downloads that may mean that the viewer app registration is not working. Can you try running this in the browser console and paste the output OCA.Viewer._mimetypes.indexOf('application/vnd.excalidraw+json')

Also does this only affect old whiteboard files or also new ones?

[nooblag]

Thank you for getting back.

AFAIK it effects all whiteboard files.

Here is output of console:

OCA.Files.Settings initialized files-main.js:1:165383
OCA.Files.Sidebar initialized files-sidebar.js:1:25972
OCA.Sharing.ShareSearch initialized files_sharing-files_sharing_tab.js:1:794
OCA.Comments.View initialized comments-comments-app.js:1:20305
Notifications permissions granted NotificationsApp-US7XApWK.chunk.mjs:38:58233
Polling interval updated to 30000 NotificationsApp-US7XApWK.chunk.mjs:38:57664
Did not start background fetcher as session_keepalive is off NotificationsApp-US7XApWK.chunk.mjs:38:55037
Got notification data, restoring default polling interval. NotificationsApp-US7XApWK.chunk.mjs:38:56619
Polling interval updated to 30000 NotificationsApp-US7XApWK.chunk.mjs:38:57664
Did not start background fetcher as session_keepalive is off NotificationsApp-US7XApWK.chunk.mjs:38:55037
OCA.Viewer._mimetypes.indexOf('application/vnd.excalidraw+json')
56

Ah and yes, sorry, I can now see there is issue with Websockets. We're using Cloudflare so our server domain can't expose port 3002 with the likes of this command per the docs:

occ config:app:set whiteboard collabBackendUrl --value="https://ourclouddomain.com:3002"

Is there any documentation on how to get this working behind Cloudflare? Or on a standard port we can make a new subdomain for, or something?

And failing that -- is it possible to just open files like before, in absence of collaborative editing? (i.e. no websockets set up?)