// troubleshooting guide · onlyoffice
ONLYOFFICE Not Loading After Docker Update
- Status
- Workaround available
- platforms:
- Docker
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · onlyoffice/not-loading-after-docker-update3 FIXES
// quick answer
After a Docker image update the editor may fail to load; pin the secret, check logs and roll back to a working tag if needed.
Most likely fix: Wait for first start
How to fix it
// try these in order, the most common fix is first
FIX 1Wait for first start
- 01Database initialization can take 1-2 minutes; 'Connection refused' often clears
Did this fix it?FIX 2Check the container
- 01Run docker logs <container_id>
- 02Look for database connection errors or low memory (needs 4 GB RAM)
Did this fix it?FIX 3Pin JWT and roll back
- 01Set -e JWT_SECRET=...
- 02Run the previous image tag until the issue is fixed in a later release
Did this fix it?
Symptoms
The editor spins forever or shows a transport/handshake error after pulling a newer image.
Why it happens
- C-01Regenerated JWT secret
- C-02Breaking change in the new release
- C-03Websocket or proxy settings not matching
- C-04Container still initializing (database start)
// this guide also covers
- onlyoffice not loading after update
- onlyoffice docker not working
Still not working?
If ONLYOFFICE keeps failing, you're not alone. See every ONLYOFFICE 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 →
Word Experienced an Error Trying to Open the File (Microsoft Word)
Other ONLYOFFICE errors
- ONLYOFFICE Not Working in Nextcloud
- ONLYOFFICE 'Document Security Token Is Not Correctly Formed' Error
- ONLYOFFICE 'Error While Downloading the Document File to Be Converted'
- ONLYOFFICE Desktop Editors Crash or Won't Start
- Why Is ONLYOFFICE So Slow?
- ONLYOFFICE Fonts Not Showing or Missing
- ONLYOFFICE DOCX Formatting Changes or Won't Open in Word
- ONLYOFFICE Community Edition 20 Connection Limit