// troubleshooting guide · onlyoffice

ONLYOFFICE Not Loading After Docker Update

Status
Workaround available
platforms:
Docker
updated:
November 16, 2026
reports:
3
Method
how we research
Share

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

  1. FIX 1Wait for first start

    1. 01Database initialization can take 1-2 minutes; 'Connection refused' often clears
    Did this fix it?
  2. FIX 2Check the container

    1. 01Run docker logs <container_id>
    2. 02Look for database connection errors or low memory (needs 4 GB RAM)
    Did this fix it?
  3. FIX 3Pin JWT and roll back

    1. 01Set -e JWT_SECRET=...
    2. 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 us

Watch ONLYOFFICE 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 ONLYOFFICE errors