// 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
Share

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

  1. FIX 1Test connectivity from the Document Server

    1. 01From the Document Server host or container, curl the storage URL
    2. 02Fix DNS, firewall or proxy issues found
    Did this fix it?
  2. FIX 2Fix DNS in Docker

    1. 01Docker defaults to Google DNS (8.8.8.8)
    2. 02Set a local DNS server for the container if there is no internet
    Did this fix it?
  3. FIX 3Resolve certificate errors

    1. 01Check logs for DEPTH_ZERO_SELF_SIGNED_CERT
    2. 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 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