Updating ONLYOFFICE Docs on Linux

Introduction

ONLYOFFICE Docs Community Edition for Linux distributions packages and the source code can be found here.

This guide will show you how to update your ONLYOFFICE Docs Community Edition Linux version to the latest version.

Our support policy is that we support only the latest stable version. We regularly release new versions of ONLYOFFICE Docs which include new features and bug fixes. If you are using an old version of ONLYOFFICE Docs, we recommend upgrading to the latest version.

Starting from version 9.4.0, ONLYOFFICE Docs uses an in-memory internal service as a database.

Shutting down ONLYOFFICE Docs

Due to how ONLYOFFICE Docs handles document saving, a document is saved only after it has been closed by all the users who edited it. To avoid data loss, you must forcefully disconnect the ONLYOFFICE Docs users when you need to stop ONLYOFFICE Docs in case of the application update. To do that, execute the following script:

documentserver-prepare4shutdown.sh

Executing the script may take a long time (up to 5 minutes) as it waits for all users to disconnect.

Updating ONLYOFFICE Docs for Linux

ImportantMake sure to replace old Document Server config files with the new ones provided by the update.

Updating using the script

Download the installation script:

curl -O https://download.onlyoffice.com/docs/docs-install.sh

Execute the following command:

bash docs-install.sh -u true

Type N and press Enter to update ONLYOFFICE Docs from DEB/RPM packages.

Updating manually

Installing dependencies

Some of the dependencies required for ONLYOFFICE Docs to work correctly are not included in Ubuntu 14.04 by default, so newer versions of ONLYOFFICE Docs require some additional steps.

The following dependencies will be installed automatically if you use Ubuntu 14.04 LTS or later when you update ONLYOFFICE Docs (in case some of them were not installed with ONLYOFFICE Docs in earlier versions for some reason):

libcurl3
libxml2
fonts-dejavu
fonts-liberation
ttf-mscorefonts-installer
fonts-crosextra-carlito
fonts-takao-gothic
fonts-opensymbol

Earlier distributions might require their manual installation.

The following steps apply only if you are updating from version 4.1 and are using Ubuntu 14.04 LTS or earlier. These distributions have reached end of life and we recommend upgrading your OS.

If you want to update version 4.1, you will need to manually add the repository containing the proper Node.js package version (this action is not required when updating version 4.2).

Add the repository:

curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -

Ubuntu distributions prior to 14.04 LTS might require some other dependencies to be installed.

Installing the new version of ONLYOFFICE Docs

For Ubuntu and derivatives

Update the repository:

sudo apt-get update

And install the latest version of ONLYOFFICE Docs:

sudo apt-get dist-upgrade

For CentOS and derivatives

sudo yum update onlyoffice-documentserver

Verifying the update

Once the installation is finished, confirm that ONLYOFFICE Docs has come back up correctly.

Check that the services are running

Make sure the core services have started:

systemctl status ds-converter ds-docservice

Both services should be shown as active (running). If either is not running, start it manually:

systemctl start ds-converter ds-docservice

Open the welcome page

Enter http://localhost in your browser address bar (or your server address if you are connecting remotely) to open the ONLYOFFICE Docs welcome page. If the page loads, the update has completed successfully.