// 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
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
FIX 1Run the checkup
- 01Open https://your-instance/checkup/
- 02Fix each warning, starting with CSP and sandbox-domain errors
Did this fix it?FIX 2Match the official nginx config
- 01Compare your config with the example nginx file in the CryptPad repository
- 02Make sure both main and sandbox domains get the same headers
- 03Do not redirect /extensions.js or add trailing slashes
Did this fix it?FIX 3Renew the sandbox certificate
- 01Issue a Let's Encrypt certificate for the sandbox domain
- 02Reload the proxy
Did this fix it?FIX 4Update the package and copy old documents
- 01Install the latest CryptPad/package release
- 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 usThe same problem in other apps
All not loading, error messages & connection guides →
Why Is Proton Drive So Slow? Uploads and Downloads (Proton Drive)
ONLYOFFICE 'Document Security Token Is Not Correctly Formed' Error (ONLYOFFICE)
Nextcloud Access Through Untrusted Domain Error (Nextcloud)
Collabora Document Loading Failed in Nextcloud (Collabora Online)
Other CryptPad errors
- CryptPad Not Loading or Stuck on Loading Drive
- CryptPad Forgot Password: Can You Recover Your Account?
- Why Is CryptPad So Slow?
- CryptPad Not Working in Safari (iPhone, iPad, Mac)
- CryptPad 2FA Lost: Locked Out Without Authenticator
- CryptPad Storage Full: Can't Create New Documents
- CryptPad Document Deleted or Expired
- CryptPad Sheets 'An Error Has Occurred' or Won't Save