Aurora Files documentation

Office document editor

Starting from v8.8, Aurora Files offers editing office documents in Files storage. The following document formats are currently supported:

  • Office Open XML - Microsoft Word (.docx, .docm, .dotm, .dotx), Excel (.xlsx, .xlsb, .xlsm), Powerpoint (.pptx, .ppsx, .pptm, .potm, .ppam, .potx, .ppsm);
  • Microsoft binary file formats - Microsoft Word (.doc), Excel (.xls), Powerpoint (.ppt, .pps)
  • Open Document Format - OpenDocument Text (.odt), OpenDocument Spreadsheet (.odx)

To enable office document editor in Aurora Files, you need OnlyOffice Docs installed. It can be installed on the same server as Aurora Files or a different one. Since OnlyOffice Docs comes as a bundle with its own webserver, we recommend installing it on a separate physical or virtual machine or in another container (in case of Docker).

OnlyOffice Docs offers installation instructions for Debian/Ubuntu, CentOS and derivatives, Windows server, it can also be installed with Docker Compose. If you choose to have Aurora Files and OnlyOffice Docs installed on the same server (without Docker used), be sure to check these guidelines.

Once OnlyOffice Docs is installed, it will be available via URL pointing to the installation location, if you enter it in web browser you should see a welcome screen of the following kind:

OnlyOffice welcome screen

Welcome screen URL is automatically obtained from OnlyOffice Docs URL by appending /welcome/ to it. If you append /healthcheck/ instead, you'll be redirected to module that tests OnlyOffice Docs installation, and if everything's OK, the output there will be: true

Then you'll need to edit data/settings/modules/OfficeDocumentEditor.config.json file of your Aurora Files installation, set Disabled to false there, and specify OnlyOffice Docs URL as DocumentServerUrl value.

NB: We're assuming that you start with a free OnlyOffice license that allows up to 20 documents edited simultaneously. Should you exceed that limitation, please consider purchasing OnlyOffice Docs license.

For advanced configuration and troubleshooting, check this documentation page. In particular, we recommend to decrease delay after document editing is done, setting it to 1 or 0 seconds.

By default, Aurora Files uses online viewer for displaying files of office document formats. To use OnlyOffice Docs as a viewer, set Disabled to true in data/settings/modules/OfficeDocumentViewer.config.json file.