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

Overview

Integrating ONLYOFFICE with ownCloud cloud storage service through a connector, available in ownCloud Marketplace or on ONLYOFFICE GitHub page, allows you to edit Office documents within the document library.

ONLYOFFICE app adds the following features:

  • An item in the new (+) menu to create DocumentSpreadsheetPresentation.
  • 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 ownCloud account using document editors? Our Desktop Editors integration guide will help you properly configure the integration between ownCloud and ONLYOFFICE Editors.

Would like to install ownCloud along with the ONLYOFFICE Office suite on your computer for development or a test-drive? Than you should use our Docker installation for Linux-based systems, so you can get 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 ownCloud.

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

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

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

Online editors integration

Installing ONLYOFFICE Document Server

You will need an instance of ONLYOFFICE Document Server that is resolvable and connectable both from ownCloud 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 ownCloud directly.

Starting with version 4.3.0, ONLYOFFICE Document Server and ownCloud 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 ownCloud 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.

Installing ownCloud ONLYOFFICE integration app

The ownCloud administrator can install the integration app from the in-built application market. or that click the upper-left hamburger menu and select Market. After that find ONLYOFFICE in the list of available applications and install it.

If the server with the ownCloud 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 ownCloud, the following steps must be performed:

  1. Go to the ownCloud server apps/ directory (or some other directory used to connect applications):
    cd apps/
  2. Get the ownCloud ONLYOFFICE integration app. There are several ways to do that:
    • Download the latest signed version from the official store for ownCloud.
    • 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-owncloud.git onlyoffice
  3. Change the owner to update the application right from ownCloud web interface:
    chown -R www-data:www-data onlyoffice
  4. In ownCloud open the ~/index.php/settings/apps?category=disabled page with Not enabled apps by administrator and click Enable for the ONLYOFFICE application.

Configuring ownCloud ONLYOFFICE integration app

To configure ONLYOFFICE application settings, click Aditional in the Admin 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. It is the secret to validate the JSON web token in the request to Document Server.

    The JWT configuration on the Document Server side can be found here.

  • Advanced server settings:
    • Document Editing Service address for internal requests from ownCloud server.
    • ownCloud 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 ownCloud.
    • 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).
    ownCloud settings tab ownCloud 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 ownCloud services, refer For Developers section.

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

Installing ONLYOFFICE Document Server with ownCloud using Docker

This guide will help you install, run and use the functionality of the ownCloud 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 ownCloud account. OwnCloud server and ONLYOFFICE office suite can not only be deployed on the Internet but also on your own computer for development or a test drive.

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

Installing 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-owncloud
  2. Once the repository is downloaded, go to docker-onlyoffice-owncloud folder
    cd docker-onlyoffice-owncloud
  3. Update submodules in the repository
    git submodule update --remote
  4. 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.

Configuring the connector

Open a browser and enter the server adress (e.g. localhost) into the address bar. On this page enter Login and Password for the administrator.

For further instructions proceed to ownCloud server setup page.

Install Wizzard ownCloud Install Wizzard ownCloud

Now you can create documents in ownCloud, which will be opened by the ONLYOFFICE Document Server. To do this, click the owncloud add object icon button and select the necessary editor.

Create file menu Create file menu

To configure ONLYOFFICE application settings, click Additional in the Admin 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. It is the secret to validate the JSON web token in the request to Document Server.

    The JWT configuration on the Document Server side can be found here.

  • Advanced server settings:
    • Document Editing Service address for internal requests from ownCloud server.
    • OwnCloud 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 ownCloud.
    • 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.
    ownCloud settings tab ownCloud 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 ownCloud services, refer to For Developers section.

Installing ONLYOFFICE Document Server with ownCloud 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 ownCloud. 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, ownCloud 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 ownCloud 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-ownCloud VM for the hypervisor that you’ve chosen.

UCS step 1

Import the virtual appliance

Now open the hypervisor and import the ONLYOFFICE-ownCloud 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, ONLYOFFICE is ready to start in a newly created UCS platform.

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 ownCloud 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 ownCloud server instance installed and configured. If not, you can refer to the Docker Compose official installation instructions.
  2. Install ONLYOFFICE Document Server. Please note that ownCloud server and ONLYOFFICE Document Server must be accessible to each other over the network.
  3. Enable our official integration app in the ownCloud administrator account.
    One of the easiest ways to install and configure all the components at once (Document Server, ownCloud server and the integration app) is to use our Docker installation. You can refer to the corresponding instructions for ownCloud.
  4. Connect your ownCloud server to ONLYOFFICE Desktop Editors.
An Internet connection is required for connecting your ownCloud 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 ownCloud server is installed, you’ll need to change the default port used by Document Server (both Document Server and ownCloud 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 ownCloud account, click the icon in the upper-right corner and choose the Market option in the menu. In the ownCloud app store, select the Tools application category in the list on the left. Find the ONLYOFFICE connector and click the Install button.

Click your user name in the upper-right corner and choose the Settings option in the menu. Click the Additional item in the Admin section of the left-side menu.

Configuring the integration app for ownCloud

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

Connecting to ownCloud server

Launch ONLYOFFICE Desktop Editors. To connect Desktop Editors to your ownCloud 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 ownCloud 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 ownCloud server domain name or IP address. When ready, click the Connect now button.
      Connect to cloud office window Connect to cloud office window
    • The ownCloud 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 ownCloud account,
      • Click the Log in button.
      Connect to cloud office window Connect to cloud office window

The Files section of your ownCloud account will open. Now you can edit your existing files and create new ones, share your documents and collaborate on them with ownCloud 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