The ownCloud administrator can install the integration app from the in-built application market. To do it, please follow these steps:

1. Click the upper-left hamburger menu.
2. Select Market.
3. Go to the Tools category.
4. Find ONLYOFFICE in the list of available applications.
5. Click the Install button.

Alternatively, the administrator can install the application manually:

1. Get the ownCloud ONLYOFFICE integration app. There are several ways to do that:
   1. Download the latest signed version from the official ownCloud store.
   2. Download the latest signed version from the application release page on GitHub. E.g.:

      wget https://github.com/ONLYOFFICE/onlyoffice-owncloud/archive/refs/tags/vX.X.X.tar.gz

      Where vX.X.X is the necessary connector version.

      Unzip the archive, e.g.:

      tar -xvzf vX.X.X.tar.gz

      Rename the folder to onlyoffice, e.g.

      mv onlyoffice-owncloud-X.X.X onlyoffice

   3. Clone the application source code and compile it yourself:

      git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice
      cd onlyoffice
      git submodule update --init --recursive

   ownCloud does not work with unsigned applications showing an alert message, so you will need to use either option a or b to get the application for your production environment.
2. Move the onlyoffice folder to the ownCloud server apps/ directory (or some other directory used to connect applications):

   cp -r /root/onlyoffice/ /var/www/owncloud/apps/

3. Go to the apps/ directory:

   cd /var/www/owncloud/apps

4. Change the owner to update the application right from the ownCloud web interface:

   chown -R www-data:www-data onlyoffice

5. In ownCloud, go to Settings > Admin > Apps, click Show disabled apps and click Enable for the ONLYOFFICE application.

To configure the ONLYOFFICE application settings, please go to Settings > Admin > Additional.

In the Server settings section, specify the following options:

• ONLYOFFICE Docs address - specify the URL address where the Document Editing Service is installed. This field is obligatory. If you install ONLYOFFICE Docs on a custom port, you must specify the port, e.g.: http://127.0. 0.1:8081/
  ImportantThe address of ONLYOFFICE Docs must be accessible from ownCloud, as well as the address of ownCloud must be accessible from ONLYOFFICE Docs.
• Disable certificate verification (insecure) - check this box to disable the certificate verification and allow ownCloud to establish connection with ONLYOFFICE Docs if you are using a self-signed certificate for your ONLYOFFICE Docs (otherwise, ownCloud will not validate a self-signed certificate and will not allow for connection to/from ONLYOFFICE Docs). This is an insecure solution, and we strongly recommend that you replace the certificate with the one issued by some CA.
• Secret key - specify the secret used to sign the data.
  Starting from ONLYOFFICE Docs v7.2, JWT is enabled by default and the secret key is generated automatically. You need to enable it on the ownCloud side as well: find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings. For more details, see the Enabling JWT for the ONLYOFFICE and ownCloud integration section of this article.
• The Advanced server settings section can be used if your network configuration does not allow for requests between the installed ownCloud and ONLYOFFICE Docs using the public addresses. In this case, specify addresses for internal requests in the corresponding fields:
  • In the ONLYOFFICE Docs address for internal requests from the server field, specify the address that is used to access Document Editing Service from ownCloud.
  • In the Server address for internal requests from ONLYOFFICE Docs field, specify the address that is used to access ownCloud from Document Editing Service.

Click the Save button. After saving the Server settings, the Common settings, Editor customization settings, and Common templates sections will appear.

In the Common settings section, you can specify the following options:

• Restrict access to the editors to following groups - check this box and select user groups that will not be allowed to use the ONLYOFFICE editors in ownCloud.
• Use ONLYOFFICE to generate a document preview - check this box for thumbnail generation via ONLYOFFICE. It will take up some disk space.
• Open file in the same tab - check this box to open a file in the current browser tab. If this option is unchecked, a file will be opened in a new browser tab.
• Keep metadata for each version once the document is edited function makes it possible to keep metadata and display changes for each document version in the version history. It will take up some disk space. You can use the Clear button to remove the metadata and free up disk space.
• The default application for opening the format - allows you to check the formats to associate with the ONLYOFFICE editors. The docx, xlsx, and pptx formats are selected by default.
  Opening in ONLYOFFICE editors will be performed only for the formats selected in this section.
• Open the file for editing - allows administrators to choose the document formats to edit via conversion to OOXML formats. The csv and txt formats are selected by default.
  Due to format restrictions, some data might be lost when saving to the formats from the list (csv, odp, ods, odt, rtf, txt).

  After you enable the corresponding option, documents in the specified formats will be immediately converted and opened in the ONLYOFFICE editor for editing after clicking on them and choosing the Open in ONLYOFFICE menu item. If a format is unchecked, the file will be opened for viewing.

In the Editor customization settings section, you can specify the following options:

• Keep intermediate versions when editing (forcesave) function allows you to send all changes to the storage directly when clicking the Save button in the ONLYOFFICE editors' interface if you want to prevent data loss. When this option is disabled, your changes are saved to the editors' cache automatically.
• Select the interface elements of the editors that you want to hide / show (Chat, More compact header, Feedback & Support, Help, Monochrome toolbar header).
• Review mode for viewing function allows you to set the default document review display mode:
  • Markup - for highlighting the proposed changes,
  • Final - for showing with changes applied,
  • Original - for showing the original document without any changes.

After making changes to the Common settings and/or Editor customization settings, click the Save button located below to save the changes.

In the Common templates section, you can click the icon and upload docx, xlsx, or pptx templates for creating new documents.

You can download or delete a template from this list using the corresponding icons.

After adding templates in the admin settings, users will be able to choose a template when creating a new document using the the add button in the ownCloud interface or via the File > Create new menu in the ONLYOFFICE editors' interface.

Using Docker Compose, you can quickly and easily deploy the preconfigured version of ONLYOFFICE Docs connected to ownCloud with all the required dependencies in the Docker containers.

1. Follow this instruction to download and install Docker to 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 docker-onlyoffice-owncloud repository. To do so, insert the following line into the Command line interface:

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

2. Once the repository is downloaded, go to the 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 until all the containers are up and running after the command above.

In the browser address bar, enter http://localhost to open the ownCloud setup page and create your admin account. Enter your Login and Password (by default, admin is used for both fields).

Now you can create and edit documents in ownCloud using ONLYOFFICE Docs without configuring any settings.

Server settings are specified during the deployment, but you can adjust Common settings, Editor customization settings, and Common templates. Please refer to the Configuring the ONLYOFFICE connector for ownCloud section to learn more about the available connector settings.

App appliances introduced by Univention are a distribution format that allows installing systems already packed with components such as ONLYOFFICE Docs and ownCloud.

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 process 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 instructions.

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

Now open the hypervisor and import the ONLYOFFICE-ownCloud virtual appliance. This guide describes 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.

1. Choose your language and enter the nearest city.
   

   The wizard will obtain the default system locale, timezone, and keyboard layout.

   
2. Set up your domain and network settings. By default, you obtain an IP address automatically. Alternatively, you can specify your IP address, net mask, and gateway manually. Enter the address of the preferred DNS server.
   
3. Select your domain settings. The Manage users and permissions directly on this system option is selected by default. It allows creating a new domain in this system. Alternatively, you can connect to the existing UCS or Microsoft Active Directory domain.
   
4. Enter your Company name, admin email address for activating ONLYOFFICE (the license file will be sent to this email address), create and confirm a new password for your administrator account.
   
5. Specify the fully qualified domain name for this system and the LDAP base:
   
6. Review your settings and make sure everything is filled out correctly. Then click the Configure System button.
   
7. Once everything is configured, ONLYOFFICE is ready to start in a newly created UCS platform.
   
   
   
   
8. Enter your IP address in the browser address bar and upload your ucs.license file received via email.
9. To log in to your ONLYOFFICE Docs and ownCloud appliance, click ownCloud in the Applications section and enter the default username and password (owncloud, owncloud).

   To log in to your Univention Management Console, click LOGIN on the top or System and domain settings in the Administration section and enter your admin email address and the password specified during the registration (see step 4).