// troubleshooting guide · onlyoffice
ONLYOFFICE 'Error While Downloading the Document File to Be Converted'
- Status
- Workaround available
- platforms:
- Nextcloud, Cloudron, Docker
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · onlyoffice/error-downloading-document-file3 FIXES
// quick answer
The Document Server cannot fetch the file from your storage server. Check network, proxy and certificates between the two.
Most likely fix: Test connectivity from the Document Server
How to fix it
// try these in order, the most common fix is first
FIX 1Test connectivity from the Document Server
- 01From the Document Server host or container, curl the storage URL
- 02Fix DNS, firewall or proxy issues found
Did this fix it?FIX 2Fix DNS in Docker
- 01Docker defaults to Google DNS (8.8.8.8)
- 02Set a local DNS server for the container if there is no internet
Did this fix it?FIX 3Resolve certificate errors
- 01Check logs for DEPTH_ZERO_SELF_SIGNED_CERT
- 02Use a trusted certificate on both servers
Did this fix it?
Symptoms
An error occurs in the document service: error while downloading the document file to be converted, when opening or converting a file.
Why it happens
- C-01Storage server not reachable from the Document Server
- C-02Certificate errors (e.g. self-signed)
- C-03Wrong internal URL or DNS inside Docker
- C-04Broken link between ONLYOFFICE and Nextcloud
// this guide also covers
- onlyoffice error while downloading the document file
- onlyoffice convert error
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 Not Loading After Docker Update
- 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