Adding a DMS provider

ONLYOFFICE Desktop Editors allows users to access the documents from the cloud and collaborate on them with their teammates. In this case, an Internet connection is required. Currently, users can connect the application to ONLYOFFICE Workspace (SaaS or on-premises), Nextcloud, ownCloud or Seafile, but you can extend this list adding your own DMS.

Follow the steps below to add your own document management system (DMS) to the connection list:

Step 1

Create a folder using the DMS provider as a name (e.g. onlyoffice) in the providers directory. The path to the folder depends on the operating system you use:

  • For Linux - /opt/onlyoffice/desktopeditors/editors/providers/
  • For Windows - %ProgramFiles%\ONLYOFFICE\DesktopEditors\providers\

Step 2

Create a config.json file to specify the integration parameters.

Parameters
Name Description Type Example
Defines the provider id used to refer to the desktop app in the JavaScript commands. string "onlyoffice"
Defines the name displayed in the provider choice section when adding a cloud. string "ONLYOFFICE"

Defines parameters for checking portal availability. A GET request is sent, after which the HTTP_STATUS_CODE = 200 response is expected:

  • url - the URL used in the request,

    type: string,

    example: "status.php";

  • headers - the headers added to the ajax request,

    type: object,

    example: {"OCS-APIREQUEST": true}.

object

Defines the relative URL that indicates that the type of the opening file is a document.

string "/apps/onlyoffice/"
You can use regular expressions for this parameter. For example, "regex:\/lib\/(?:[\w-]{32,})\/file\/".
Defines the relative URL added to the entered IP or domain when creating a new connection. string "/"

Defines the icons for portals:

  • connectionsList - the path to the icon for the connection list,

    type: string,

    example: "./assets/listicon.svg";

  • buttonLogo - the path to the icon for the provider button on the connection page when the portal list is empty,

    type: string,

    example: "./assets/buttonlogo.svg".

object
Example
{
    "provider": "onlyoffice",
    "name" : "ONLYOFFICE",
    "check": {
        "url": "status.php",
        "headers": {
            "OCS-APIREQUEST": true
        }
    },
    "editorPage" : "/apps/onlyoffice/",
    "startPage" : "/",
    "icons" : {
        "connectionsList" :  "./assets/listicon.svg",
        "buttonLogo" : "./assets/buttonlogo.svg"
    }
}

Step 3

Create two icons for the application page and put to the folder specified in the config.json file:

  1. The icon for the connection list. The required icon size is 36x36:

    Connection list
  2. The icon for the provider button on the connection page when the Connected clouds list is empty. The required icon size is 148x38:

    Provider button

Supported image formats are .png, .jpeg, .svg. We recommend using a .svg file for correct display on HiDPI monitors with a 200% scale in the system.

Step 4

Launch ONLYOFFICE Desktop Editors or restart it if needed and switch to the Connected clouds section to check if the connection works correctly.