Articles with the tag:
Close
Changelog
Close
Help Center
Integration
  • All
  • Overview
  • Online editors integration
    • Installing ONLYOFFICE Document Server with Nextcloud using Docker
    • Installing ONLYOFFICE integrated with Nextcloud on Cloudron
    • Installing ONLYOFFICE Document Server with Nextcloud on a virtual machine using UCS
  • Desktop editors integration

Overview

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 Document Server’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.

Online editors integration

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

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

Installing ONLYOFFICE Document Server

You will need an instance of ONLYOFFICE Document Server 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 Document Server documentation page: Document Server for Linux. ONLYOFFICE Document Server must also be able to POST to Nextcloud directly.

Starting with version 4.3.0, ONLYOFFICE Document Server 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 Document Server as by default both ONLYOFFICE Document Server and Nextcloud work on port 80. Or you can use Document Server behind a proxy, please refer to this article to learn how you can configure it.

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

Installing Nextcloud ONLYOFFICE integration app

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 Document Server 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.

Installing ONLYOFFICE Document Server with Nextcloud using Docker

This guide will help you install, run and use the functionality of the Nextcloud server along with the ONLYOFFICE Document Server 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.

Install Docker and Docker Compose

  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.

Install servers

  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.

Run and configure the server

  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.

    Install Wizzard Nextcloud Install Wizzard Nextcloud
  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 Document Server. To do this, click the Nextcloud add object icon button and select the necessary editor.

Create file menu Create file menu

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

Adminitration tab Adminitration tab

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 Document Server - 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.
    Nextcloud settings tab Nextcloud settings tab

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.

Installing ONLYOFFICE integrated with Nextcloud on Cloudron

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.

Install and configure Cloudron on your server

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.

Install ONLYOFFICE on Cloudron

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

Install Nextcloud on Cloudron

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

Install ONLYOFFICE connector for Nextcloud

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

Configure ONLYOFFICE app

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):

Cloudron Nextcloud connector Cloudron Nextcloud connector

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.

Configuring Nextcloud ONLYOFFICE integration app

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 Document Server - 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.
    Nextcloud settings tab Nextcloud settings tab

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.

Installing ONLYOFFICE Document Server with Nextcloud on a virtual machine using UCS

App appliances introduced by Univention are a distribution format that allows installing systems already packed with components such as ONLYOFFICE Document Server 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.

Download the necessary components

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.

UCS step 1

Import the virtual appliance

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

Install the application

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.

UCS step 2 UCS step 2

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.

UCS step 3 UCS step 3

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).

UCS step 4 UCS step 4

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

UCS step 5 UCS step 5

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

UCS step 6 UCS step 6

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

UCS step 7 UCS step 7

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

UCS step 8 UCS step 8

UCS step 9 UCS step 9

Desktop editors integration

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 Document Server. Please note that Nextcloud server and ONLYOFFICE Document Server 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 (Document Server, 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.
An Internet connection is required for connecting your Nextcloud server, as well as for real-time co-editing.

Installing Document Server

The easiest way to install Document Server 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 Document Server on the same machine where your Nextcloud server is installed, you’ll need to change the default port used by Document Server (both Document Server and Nextcloud work on port 80 by default).

When installing Document Server 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 Document Server to use.

To make sure that Document Server 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 Document Server welcome page should open.

Installing ONLYOFFICE integration connector

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 Document Server 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.

Connecting to Nextcloud server

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.
    Connect to cloud tab Connect to cloud tab
  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.
      Connect to cloud office window Connect to cloud office window
    • 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.
      Connect to cloud office window Connect to cloud office window

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.

Managing your connected accounts

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 Exit icon 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.

Connected accounts list Connected accounts list
Download Best editors on your website Let your site users view, edit and collaborate
on all types of text, spreadsheet and presentation files
You Might Also Like This:
Close