How to integrate ONLYOFFICE with Nextcloud

Nextcloud is a fork of the ownCloud project that offers you the ability to run a cloud storage service that you administer and control yourself. Besides, you can extend its functionality using different apps from the Nextcloud App Store. Recently, this collection was updated with a new app - ONLYOFFICE - that allows users to integrate Nextcloud, like ownCloud, with online document editors from ONLYOFFICE to easily create, edit and collaborate on text documents, spreadsheets, and presentations.

1. Software Requirements

You will need:

  • Nextcloud version 11.0.2 or later. To install it, follow the instructions here.
  • ONLYOFFICE Document Server version 4.2 or later.
  • OwnCloud/Nextcloud ONLYOFFICE integration app.

2. Installing ONLYOFFICE Document Server v.4.2

To install the latest version of ONLYOFFICE Document Server, you can use the .deb or .rpm packages, or an official Docker image. The easiest way is to use Docker.

Before you begin the installation, make sure your machine meets the following system requirements:

  • CPU: dual-core 2 GHz or better
  • RAM: 4 GB or more
  • HDD: at least 2 GB of free space
  • At least 2 GB of swap
  • OS: amd64 Linux distribution with kernel version 3.10 or later
  • Docker: version 1.10 or later

Then run Docker and execute the following command:

sudo docker run -i -t -d -p 80:80 onlyoffice/documentserver

This will install Document Server and all the dependencies it needs.

Run ONLYOFFICE from your browser to check its work.

Document server is running

Please note that ONLYOFFICE Document Server and Nextcloud must be installed on different machines, otherwise integration problems might occur.

3. Enabling ownCloud/Nextcloud ONLYOFFICE integration app

Download ownCloud/Nextcloud ONLYOFFICE integration app from GitHub and place it into the /apps directory on your Nextcloud server:

cd apps/ 
git clone onlyoffice

Access Nextcloud, open the page with Not enabled apps and click Enable for the ONLYOFFICE application.

NextCloud apps

4. Configuring ownCloud/Nextcloud ONLYOFFICE integration app

Open the Nextcloud Admin settings, go to the ONLYOFFICE section and enter the address of the server with ONLYOFFICE Document Server installed:


Nextcloud ONLYOFFICE integration app

If you copy the Document Server URL from the browser, please do not include /welcome/.

5. Getting started with ONLYOFFICE

To edit your document, just select the Open in ONLYOFFICE option from the menu for the corresponding document.

Getting started with ONLYOFFICE

To create a new text document, spreadsheet, or presentation, click the + button at the top of the Nextcloud interface and select an appropriate file type.

Edit documents in ONLYOFFICE

Share this page:

Suggested articles

7 Comment(s)

Add comment


By: Travis Hershberger

I just tried this today (March 27, 2017).  I have a separate docker host and NextCloud 11 server.  

After starting the docker container as instructed (sudo /usr/bin/docker run -i -t -d -p 80:80 onlyoffice/documentserver), the test page works via http, but not https.

The NextCloud integration is throwing an error "ONLYOFFICE app not configured. Pleaase contact admin"

I'm assuming something is broken with the docker container not responding to https requests.  I'm looking at/for logs now to get more information.

By: Tati

Hello Travis,

Please use these instructions to make Document Server work via https -

By: Vincent

This tutorial is brillant ! I've integrated OnlyOffice with NextCloud without any problems !

Just a question regarding the step 2 (Installing ONLYOFFICE Document Server v.4.2) : How to get the document server URL with httpS ? In your example the Document Editing Service Address is always with http only


By: ariel

tengo ya mi server de nextcloud y mi document server en mi misma red, pero si mi nextcloud server esta utilizando otro puerto que no sea el 80 no puede comunicarse con mi document server de onlyoffice, hay algun lugar donde le diga que escuche y responda a una ip exacta con un puerto que no sea el 80?

gracias por su ayuda

By: H. B.

Is it eniough to use a second vm for onlyoffice or must i use another physical device? Can the two devices be in the same local network or is that causing problems?

By: santosh

ONLYOFFICE document server still isn't working. When I click, "Save" in the ONLYOFFICE settings, I receive this error, "Error when trying to connect (Error occurred in the document service: Error while downloading the document file to be converted.)"

By: Sjoerd

I use swag/reverse proxy with Duckdns. My problem was solved using https:// www.myduckdns. org/ onlyoffice as onlyoffice address. Include www and have proxy configured with wildcard