Is this Nethserver module helpful to you?
Please consider donating to the author

Thank you kindly!

2019/03/04 12:06 · HF

Onlyoffice (online office suite)

Onlyoffice document server is an open document editing server. It's used in Nextcloud or Webtop to edit office documents. You need to install Nextcloud or Webtop from Software Center to make this module work. Nethserver-nginx is installed as requirement. Self-signed certs are possible in Nextcloud (thanks to kizotux and flatspin) for test environments.

Onlyoffice documentserver needs port 8082 to be reachable. Just edit fw_onlyoffice access in services. It opens red and green by default.

Install Nextcloud or Webtop first to be able to use Onlyoffice.

yum -y install
yum -y install
yum -y install
yum -y install nethserver-onlyoffice --enablerepo=mrmarkuz

mrmarkuz repo is required for installation/updates.

This way you always get the recent version but it may break something so choose wisely.

yum -y install

You have to install Nextcloud or Webtop from Software Center or via command line to actually use onlyoffice:

yum -y install nethserver-nextcloud
yum -y install nethserver-webtop5

In Webtop the documentserver does not work with the internal Webtop admin user.

Starting from documentserver 5.5.0 nodejs is not required anymore. Be careful as this step adds a repository that provides newer versions of nodejs that replaces the nodejs provided by centos which may lead to problems. I am working on nvm integration to not touch system packages.

curl -sL | sudo bash -
yum -y install

Actual version is 6.3.1.

yum -y install

If you installed the onlyoffice repo just do

yum -y install onlyoffice-documentserver

DocumentServer 5.4.2 - Last Documentserver with mobile editing enabled

yum -y install

Downgrade example to 5.4.2

To downgrade just use

yum downgrade


To upgrade an existing installation of documentserver issue:

yum upgrade

Old upgrade path:

yum upgrade

where 'x.x.x' would be the actual version you want to install. For an overview of available versions, please see:

Install nethserver-onlyoffice:

yum -y install nethserver-onlyoffice --enablerepo=mrmarkuz

Nextcloud addon is autoconfigured. If you installed Nextcloud after nethserver-onlyoffice just run

signal-event nethserver-onlyoffice-update

to setup the onlyoffice nextcloud app.

The host is set to HOST.DOMAIN.TLD by default. In Nextcloud 13 the FQDN only works with valid, not self-signed certificates. A token is used for securing the documentserver.

Self-signed certificate

If you want to use a self signed certificate you have to change the configuration:

config setprop fw_onlyoffice RejectUnauthorized false

Apply the changes:

signal-event nethserver-onlyoffice-update

Set host/domain

By default systemname.domainname is used. To change it do the following

config setprop fw_onlyoffice host DOMAIN.TLD

or use IP for self-signed certs

config setprop fw_onlyoffice host

and apply the config

signal-event nethserver-onlyoffice-update
Allow site in browser if self-signed cert is used

Browse to https://NETHSERVER:8082 and allow the site in your browser otherwise the documentserver may not work.

Save button

If something is not working it may help to click the “Save” button in the ONLYOFFICE app settings in the Nextcloud admin settings. At least you should get an error message.


If you downgraded/upgraded it may help to reinstall, just replace {VERSION} with 5.4.0-2 for example:

yum -y reinstall{VERSION}/onlyoffice-documentserver.x86_64.rpm

Remove database

After upgrades or downgrades it may make sense to drop the database to force recreation:

su - postgres -c "psql -c 'drop database onlyoffice;'"
signal-event nethserver-onlyoffice-update

nodejs 6 from epel installed so nodejs 8 is not installing from repo

You have to remove the epel nodejs which removes onlyoffice-documentserver too.

yum remove nodejs

Now you have to reinstall onlyoffice-documentserver.

"violates local access rules" error


'allow_local_remote_servers' => true,

to /usr/share/nextcloud/config/config.php.

Maybe your DNS provides a local IP address for the Onlyoffice host. This way you can allow local network addresses.

Please raise Issues on NethServer Community