Integrating ONLYOFFICE with Nextcloud cloud storage service through a connector, available in Nextcloud app store and on ONLYOFFICE GitHub page, allows you to edit Office documents within the document library.

ONLYOFFICE app adds the following features:

• The app will create an item in the new (+) menu to create Document, Spreadsheet, Presentation.
• It will also create a new Open in ONLYOFFICE menu option within the document library for Office documents.
• Editing the following formats: csv, docx, pptx, txt, xlsx. These are also available for viewing together with pdf.
  In addition, the edited files of the corresponding type can be converted into the Open Office XML formats: dot, dotx, epub, htm, html, odp, odt, pot, potm, potx, pps, ppsm, ppsx, ppt, pptm, rtf, xls, xlsm, xlsx, xlt, xltm, xltx.

You are already using ONLYOFFICE Desktop Editors and would like to be able to manage files stored in your Nextcloud account using document editors? Our Desktop Editors integration guide will help you properly configure the integration between Nextcloud and ONLYOFFICE Editors.

Would like to install Nextcloud along with the ONLYOFFICE Office suite on your computer for development or a test-drive? Then you should use our Docker installation for Linux-based systems or use Cloudron application platform, so you can get you a complete view of the ONLYOFFICE Docs’s functionality and features. Want to spend as little time as possible on installation? Use the app appliance of Univention to install an already integrated and preconfigured Nextcloud.

In case you have any documents stored in your Nextcloud account, refer to this guide to easily synchronize them with the Documents module of your up and running ONLYOFFICE portal.

Integration of Nextcloud and mobile version of ONLYOFFICE is possible using our applications for iOS and Android. For more details, follow our video guide and Connecting third-party clouds sections for iOS and Android.

Visit our For Developers page to find out more about the Nextcloud ONLYOFFICE integration app in details.

Installing ONLYOFFICE app enables users to edit office documents from Nextcloud using ONLYOFFICE Docs.

The latest connector signed versions are available in the Nextcloud official store.

You will need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Nextcloud and any end clients (version 4.2.7 and later are supported for use with the app). If that is not the case, use the official ONLYOFFICE Docs documentation page: ONLYOFFICE Docs for Linux. ONLYOFFICE Docs must also be able to POST to Nextcloud directly.

Starting with version 4.3.0, ONLYOFFICE Docs and Nextcloud can be installed either on different computers, or on the same machine. In case you select the latter variant, you will need to set up a custom port for ONLYOFFICE Docs as by default both ONLYOFFICE Docs and Nextcloud work on port 80. Or you can use ONLYOFFICE Docs behind a proxy, please refer to this article to learn how you can configure it.

The easiest way to start an instance of ONLYOFFICE Docs is to use Docker Compose.

The Nextcloud administrator can install the integration app from the in-built application market. For that go to the user name and select Apps. After that find ONLYOFFICE in the list of available applications and install it.

If the server with the Nextcloud installed does not have an Internet access, or if you need it for some other reason, the administrator can install the application manually. To start using ONLYOFFICE Docs with Nextcloud, the following steps must be performed:

1. Go to the Nextcloud server apps/ directory (or some other directory used to connect applications):

   cd apps/

2. Get the Nextcloud ONLYOFFICE integration app. There are several ways to do that:
   • Download the latest signed version from the official store for Nextcloud.
   • Or you can download the latest signed version from the application release page on GitHub.
   • Or you can clone the application source code and compile it yourself:

     git clone https://github.com/ONLYOFFICE/onlyoffice-nextcloud.git onlyoffice

3. Change the owner to update the application right from Nextcloud web interface:

   chown -R www-data:www-data onlyoffice

4. In Nextcloud open the ~/index.php/settings/apps?category=disabled page with Not enabled apps by administrator and click Enable for the ONLYOFFICE application.

This guide will help you install, run and use the functionality of the Nextcloud server along with the ONLYOFFICE Docs and properly configure it, so that you can easily create new and edit existing files saved in your Nextcloud account. Nextcloud server and ONLYOFFICE office suite can not only be placed on the Internet but also on your own computer for development or a test drive.

1. Follow this instruction to download and install Docker on your computer. Docker is a program for automating application development and management in container-enabled environments.
2. Then, follow this instruction to download and install the Docker Compose package manager, which allows you to describe and run multi-container applications.

1. Download the latest version of the repository. To do so, isnert the following line into the Command line interface

   git clone https://github.com/ONLYOFFICE/docker-onlyoffice-nextcloud

2. Once the repository is downloaded, go to docker-onlyoffice-nextcloud folder

   cd docker-onlyoffice-nextcloud

3. Launch Docker Compose

   sudo docker-compose up -d

   you might need to wait a couple of minutes when all the containers are up and running after the command above.

1. Open a browser and enter the server adress (e.g. localhost) into the address bar. On this page enter Login and Password for administrator and follow the tips and instructions of the Nextcloud Installation Wizard.

   For further instructions, proceed to Nextcloud server setup page.

   
2. Once you're finished with the Wizard, go to the project folder and run

   bash set_configuration.sh

   If you would like to use Docker as a non-root user, you should now consider adding your user to the “docker” group with the following command:
   sudo usermod -aG docker $USER
   then log out and log back in.

Now you can create documents in Nextcloud, which will be opened by the ONLYOFFICE Docs. To do this, click the button and select the necessary editor.

To configure ONLYOFFICE application settings, click ONLYOFFICE in the Administration section, located in Settings.

In the ONLYOFFICE application settings section you can edit and specify the following options:

• Document Editing Service address - specify the URL address on which the Document Editing Server is installed.
• Secret key - specify the secret used to sign the data.
• Advanced server settings:
  • Document Editing Service address for internal requests from Nextcloud server.
  • Nextcloud server address for internal requests from the Document Editing Service.
• Connect to demo ONLYOFFICE Docs - used to test the capabilities of the editor. By enabling this option, do not open any important documents with sensitive data.
• Common settings:
  • Restrics access to the editors to following groups - check the box and select user groups that will be forbidden from using ONLYOFFICE editors on Nextcloud.
  • Open file in the same tab - check the box for the editor not to open in a new tab, but in the current one.
• Check the formats that will be automatically opened by ONLYOFFICE editors.
• Check the formats that ONLYOFFICE editors will open for editing.
• Select the interface elements of the editors that you want to hide / show (Chat, More compact header, Feedback & Support, Help, Toolbar tabs).
• Watermark settings when opening the editor.
  

After making changes to the application settings, click the Save button located below each section to save the changes.

For more information on integrating ONLYOFFICE editors with Nextcloud services, refer to For Developers section.

Don't forget to connect Nextcloud as a third-party storage in your ONLYOFFICE Documents mobile application. To find our more information on how to do it watch this video guide.

This guide will show you how to easily run ONLYOFFICE in combination with Nextcloud on a Cloudron instance.

Cloudron is a platform that offers sysadmin inside for self-hosted open-source tools and allows installing, managing and securing web apps on your server with less effort.

Create a fresh Ubuntu Bionic 18.04 x64 server and run the following commands:

wget https://cloudron.io/cloudron-setup
chmod +x ./cloudron-setup
./cloudron-setup --provider <digitalocean | hetzner | generic | ovh ...]

Once done, proceed to https://<IP> in your browser and accept the self-signed certificate.

In the appeared Cloudron setup wizard, provide a domain like example.com.

Select the DNS service in which the domain is hosted from the drop-down list and enter the necessary info (such as API key, token, etc.). In case your hosting service is not on the list, domain setup can be done manually.

Once DNS setup is complete, you’re redirected to https://my.example.com. Create a Cloudron admin account: enter administrator user name, email and password.

Go to the Cloudron App Store, find and install ONLYOFFICE app on your server with Cloudron.

Go to the Cloudron App Store, find and install Nextcloud app on your server with Cloudron.

Find and install the latest version of ONLYOFFICE integration app from the Nextcloud app library.

Open the web terminal via the Console section to access the app's file system and edit the file /app/data/config/production-linux.json changing the default secret to your own unique secret key.

Go to the Settings page within your Nextcloud and select the ONLYOFFICE section on the left panel. Then, adjust the domain and specify the secret key (use the same one you’ve already changed in the app’s config file):

Go back to the web terminal and run

supervisorctl restart ds:*

That’s all. Now you can work on your documents using ONLYOFFICE editors within Nextcloud on your Cloudron instance.

To configure ONLYOFFICE application settings, click ONLYOFFICE in the Administration section, located in Settings.

In this menu you can edit and specify the following options:

• Document Editing Service address - specify the URL address on which the Document Editing Server is installed.
• Secret key - specify the secret used to sign the data.
• Advanced server settings:
  • Document Editing Service address for internal requests from Nextcloud server.
  • Nextcloud server address for internal requests from the Document Editing Service.
• Connect to demo ONLYOFFICE Docs - used to test the capabilities of the editor. By enabling this option, do not open any important documents with sensitive data.
• Common settings:
  • Restrics access to the editors to following groups - check the box and select user groups that will be forbidden from using ONLYOFFICE editors on Nextcloud.
  • Open file in the same tab - check the box for the editor not to open in a new tab, but in the current one.
• Check the formats that will be automatically opened by ONLYOFFICE editors.
• Check the formats that ONLYOFFICE editors will open for editing.
• Select the interface elements of the editors that you want to hide / show (Chat, More compact header, Feedback & Support, Help, Toolbar tabs).
• Watermark settings when opening the editor.
  

After making changes to the application settings, click the Save button located below each section to save the changes.

For more information on integrating ONLYOFFICE editors with Nextcloud services, refer For Developers section.

Do not forget to watch our video guide which will illustrate you how to connect ONLYOFFICE online editors to Nextcloud using ONLYOFFICE application.

App appliances introduced by Univention are a distribution format that allows installing systems already packed with components such as ONLYOFFICE Docs and Nextcloud. In this guide, we will describe why it is convenient and how to install ONLYOFFICE on your server using this method.

Univention, an open-source corporate infrastructure developer, introduced a handy method of installing systems already equipped with third-party components – virtual app appliances. These are VirtualBox or VMware images that include the app, UCS management system and the UCS runtime environment.

The following virtual images contain Univention Corporate Server, Nextcloud and ONLYOFFICE. The apps work out of the box with the additionally created auto-configuration that makes sure that the required ONLYOFFICE add-on in Nextcloud is configured correctly. The installation is far easier than a classic manual method: no manual steps by the administrator are needed.

First, you need to install the hypervisor for the virtual machine. Choose between VMware Workstation Player or VirtualBox  and follow the documentation for detailed installation guide.

Then download ONLYOFFICE-Nexctloud VM for the hypervisor that you’ve chosen.

Now open the hypervisor and import the ONLYOFFICE-Nextcloud virtual appliance. This guide can show you exactly how to do this in both platforms.

Once the image is successfully imported, start the Virtual Machine. Go through the booting process via the installation wizard, following the steps below.

The first step is localization. Here, select the nearest city for the wizard to adjust the correct timezone, keyboard layouts, and other parameters.

Next, set up your domain and network. Select your IP manually or choose the automatic option, then fill in the address of the DNS server where the system will be hosted.

In the next step, either connect to the existing UCS or Microsoft Active Directory domain, or set up the new one. To create the new domain, you need to choose manage users and permissions directly on this system (this guide is oriented at setting up a new system).

Further, fill in your Company name, admin email address for activating ONLYOFFICE, and create a new password.

Specify the full domain name for this system and the LDAP base:

Review your settings and make sure everything is filled out correctly. Then click the Configure System button.

Once everything is configured, your new ONLYOFFICE-Nextcloud system is ready for action!

ONLYOFFICE suite allows you to edit the files stored in your Nextcloud account and collaborate on them using desktop ONLYOFFICE editors. Thereby, you can use not only online collaboration tools, but also the features available in your desktop application only. To take full advantage of all these editing options you’ll need to install and configure several components:

1. It's supposed that you already have a Nextcloud server instance installed and configured. If not, you can refer to the Nextcloud official installation instructions.
2. Install ONLYOFFICE Docs. Please note that Nextcloud server and ONLYOFFICE Docs must be accessible to each other over the network.
3. Enable our official integration app in the Nextcloud administrator account.
   One of the easiest ways to install and configure all the components at once (ONLYOFFICE Docs, Nextcloud server and the integration app) is to use our Docker installation. You can refer to the corresponding instructions for Nextcloud.
4. Connect your Nextcloud server to ONLYOFFICE Desktop Editors.

The easiest way to install ONLYOFFICE Docs is to use Docker. Execute the following command:

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

If you want to install ONLYOFFICE Docs on the same machine where your Nextcloud server is installed, you’ll need to change the default port used by ONLYOFFICE Docs (both ONLYOFFICE Docs and Nextcloud work on port 80 by default).

When installing ONLYOFFICE Docs using Docker, you can easily change the mapping port with the following command:

sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always onlyoffice/documentserver

Where <PORT_NUMBER> is the number of port you want ONLYOFFICE Docs to use.

To make sure that ONLYOFFICE Docs is installed successfully, enter the IP address and, optionally, port (if it has been changed during the installation) in your browser address bar, e.g. http://192.168.3.202:81 - the ONLYOFFICE Docs welcome page should open.

In your Nextcloud account, click your user name in the upper-right corner and choose the Apps option in the menu. In the Nextcloud app store, select the Office & text application category in the list on the left. Find the ONLYOFFICE connector and click the Enable button.

Click your user name in the upper-right corner and choose the Settings option in the menu. Click the ONLYOFFICE item in the left-side menu to open the ONLYOFFICE application settings page.

Configuring the integration app for Nextcloud

When the connector is installed, you need to configure it. On the ONLYOFFICE application settings page, specify the address of the machine where the ONLYOFFICE Docs is installed in the Document Editing Service address field. If you’ve changed the port during the installation, do not forget to specify it, e.g. http://192.168.3.202:81. Click the Save button to apply the settings.

To find out more details on configuring the integration app you can refer to corresponding articles for Nextcloud.

Launch ONLYOFFICE Desktop Editors. To connect Desktop Editors to your Nextcloud server, perform the following actions:

1. Switch to the Connect to cloud section at the left side panel.
2. Click the necessary cloud service button. The following three options are available: ONLYOFFICE, Nextcloud, ownCloud. Alternatively, you can use the Connect now link at the bottom.
   
3. If you pressed the corresponding service button, the Connect to cloud office window opens with the Nextcloud selected. If you used the Connect now link, choose the necessary cloud storage from the drop-down list.
   • in the Cloud office URL field, enter your Nextcloud server domain name or IP address. When ready, click the Connect now button.
     

   • The Nextcloud sign in page will open in a new tab of the Desktop Editors interface.

     • Specify your Username or email and the Password you use to access your Nextcloud account,
     • Click the Log in button.
     

The Files section of your Nextcloud account will open. Now you can edit your existing files and create new ones, share your documents and collaborate on them with Nextcloud users using ONLYOFFICE editors.

Click the logo in the upper left corner of the Desktop Editors interface to return to the main program window, then switch to the Connect to cloud section to view the Connected clouds list. Right-click on a connected cloud office and use one of the available contextual menu options:

• Open - to switch to the corresponding cloud storage tab, if you are already logged in to this account, or to open the Connect to cloud office window, if you are not currently logged in (in such a case, you will need to enter your credentials),
• Logout - to exit from your account,
  You can also click the icon to the right of the account to exit from it.
• Remove from list - to disconnect the selected account and remove it from the list.

If you have several accounts or clouds, use the Add cloud button to connect one more account.