Configuring OnlyOffice Docs with non-standard port

When enabling office document editor and installing OnlyOffice Docs, usually it's recommended to install it on a separate server, as it provides a complete webserver bundle which may conflict with an existing web server setup.

Still, it's possible to have OnlyOffice Docs installed on the same server as Aurora Corporate. It comes with Nginx webserver so, for example, if you already run Apache you can have both on the same system, as long as they don't use the same set of ports.

The following guidelines assumed OnlyOffice Docs is installed on CentOS - we'll cover the case of Debian/Ubuntu, too.

NB: be sure to backup all the configuration files before and after making changes; there's a chance some of the configuration files may get overwritten during the upgrade.

1. By default, Nginx would use port 80 and won't start if it's already used by another webserver running there. You'll need a different port supplied in /etc/nginx/nginx.conf file:

server {
        listen       808 default_server;
#      listen       [::]:80 default_server;

NB: This port is only specified as a default value and will not actually be used for accessing OnlyOffice Docs.

2. DocumentServer needs to have a dedicated port as well, specified in /etc/onlyoffice/documentserver/default.json file:

"services": {
    "CoAuthoring": {
        "server": {
            "port": 8081,

3. Now we need to tell Nginx webserver which port is used by DocumentServer, /etc/onlyoffice/documentserver/nginx/includes/http-common.conf file:

upstream docservice {
  server localhost:8081;
}

4. One last thing is to tell Nginx where web scripts of DocumentServer are found, /etc/onlyoffice/documentserver/nginx/ds.conf file:

server {
  listen 0.0.0.0:8088;
  listen [::]:8088 default_server;
  server_tokens off;

NB: this is actually the port that will be used in URL for accessing OnlyOffice Docs.

If you install OnlyOffice Docs on Debian/Ubuntu, the above approach mostly applies, with 2 exceptions:

1) Before installing OnlyOffice Docs, specify port from section 4 by entering the following command:

echo onlyoffice-documentserver onlyoffice/ds-port select 8088 | sudo debconf-set-selections

2) Port from section 1 is specified in /etc/nginx/sites-available/default configuration file.