// troubleshooting guide · cryptpad

Self-Hosted CryptPad OnlyOffice Apps Not Loading

Status
Workaround available
platforms:
Docker, YunoHost, Cloudron, Linux
updated:
November 16, 2026
reports:
5
Method
how we research
Share

RUNBOOK · cryptpad/onlyoffice-self-hosted4 FIXES

// quick answer

Blank or broken Sheets/Docs/Slides on your own instance are almost always a sandbox-domain or reverse-proxy problem. Run /checkup/, fix CSP headers and the sandbox certificate, then make sure OnlyOffice files match your version.

Most likely fix: Run the checkup

How to fix it

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

  1. FIX 1Run the checkup

    1. 01Open https://your-instance/checkup/
    2. 02Fix each warning, starting with CSP and sandbox-domain errors
    Did this fix it?
  2. FIX 2Match the official nginx config

    1. 01Compare your config with the example nginx file in the CryptPad repository
    2. 02Make sure both main and sandbox domains get the same headers
    3. 03Do not redirect /extensions.js or add trailing slashes
    Did this fix it?
  3. FIX 3Renew the sandbox certificate

    1. 01Issue a Let's Encrypt certificate for the sandbox domain
    2. 02Reload the proxy
    Did this fix it?
  4. FIX 4Update the package and copy old documents

    1. 01Install the latest CryptPad/package release
    2. 02If old documents still fail, use Create copy on them in the drive
    Did this fix it?

SANDBOX · cryptpad RUNS IN YOUR BROWSER

Try it: fix grammar, rewrite with AI and check text in other apps

A hands-on CryptPad-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

Rich text works but Sheets, Documents or Presentations stay blank; console shows CSP blocks, 'window.DocsAPI is undefined' or 404s for /common/onlyoffice/.

Why it happens

  • C-01Missing 'content-security-policy' headers on the sandbox domain
  • C-02Missing or expired certificate for the sandbox domain
  • C-03Reverse proxy redirecting or stripping headers
  • C-04OnlyOffice API path changed after a package update
  • C-05Port conflict with another service

// this guide also covers

  • cryptpad onlyoffice not loading
  • cryptpad sandbox domain error
  • cryptpad content-security-policy headers
  • cryptpad self hosted sheets not working

Still not working?

If CryptPad keeps failing, you're not alone. See every CryptPad 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 CryptPad 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 CryptPad errors

All 11 CryptPad errors and fixes →