Starting from version 6.4, ONLYOFFICE Docs offers support for the Web Application Open Platform Interface Protocol (WOPI) - a REST-based protocol that is used to integrate your application with an online office. WOPI operations allow you to open files stored on a server, edit and save them.
This documentation describes:
For further information on the WOPI protocol, please read the WOPI documentation.
All the necessary WOPI settings you can find and change in the configuration file which can be found (or created) at the following path:
To enable WOPI, set the wopi.enable parameter in the ONLYOFFICE Docs config to true:
Name | Description | Type | Example |
wopi.enable | Defines if WOPI is enabled or not. The default value is false. | boolean | true |
{ "wopi": { "enable": true } }
ONLYOFFICE Docs can accept WOPI requests only from the trusted integrator. The IP address of such an integrator must be included in the WOPI domain allow list. At the same time, access for all the other integrators must be denied.
Follow the steps below to configure the ONLYOFFICE Docs IP filter:
Open the /etc/onlyoffice/documentserver/local.json file using any available text editor:
"ipfilter": { "rules": [ { "address": "ip_address", "allowed": true }, { "address": "*", "allowed": false } ], "useforrequest": false, "errorcode": 403 }
Change the following default settings. Enter your "ip_address" that can contain:
Restart the services for the config changes to take effect:
For RPM/DEB packages:
systemctl restart ds-*
For Docker:
supervisorctl restart all
Starting from version 8.0, the WOPISrc query parameter is added to the requests from the browser to the server. This allows you to create several independent instances of ONLYOFFICE. Load balancing requests with WOPISrc ensure that collaborative editing works correctly: all users editing the same document are served by the same server.
For WOPI, the parameter sent by the integrator is used. For Docs API, the shardkey parameter is used.