Atlantic.Net Blog

How to Install ONLYOFFICE Docs on Debian 10

ONLYOFFICE Docs is a free and open-source document server for small and medium-sized organizations. This web-based collaboration suite can be used to manage documents, projects, teams and customer relations from a central location. ONLYOFFICE Docs supports several Open XML formats including .xlsx, .pptx, and .docx and enables collaborative editing in real-time. You can use the ONLYOFFICE Docs API to integrate the ONLYOFFICE Document Editor into your website to manage editors.

In this tutorial, we will show you how to install ONLYOFFICE Docs on Debian 10.


  • A fresh Debian 10 VPS on the Atlantic.Net Cloud Platform
  • A root password configured on your server

Step 1 – Create Atlantic.Net Cloud Server

First, log in to your Atlantic.Net Cloud Server. Create a new server, choosing Debian 10 as the operating system, with at least 2GB RAM. Connect to your Cloud Server via SSH and log in using the credentials highlighted at the top of the page.

Once you are logged in to your Debian 10 server, run the following command to update your base system with the latest available packages.

apt-get update -y

Step 2 – Install Nginx and Other Dependencies

First, you will need to install the Nginx webserver to serve the ONLYOFFICE Dcos. You can install it with the following command:

apt-get install nginx nginx-extras -y

After installing the Nginx web server, you will need to install RabbitMQ-server and Redis in your system. You can install both using the following command:

apt-get install redis-server rabbitmq-server gnupg2 curl -y

Once both packages are installed, start the RabbitMQ and Redis service with the following command:

systemctl start rabbitmq-server
systemctl start redis-server

Once you are finished, you can proceed to the next step.

Step 3 – Install and Configure PostgreSQL

ONLYOFFICE uses PostgreSQL as a database backend, so you will need to install it in your server. You can install it using the following command:

apt-get install postgresql -y

Once installed, start the PostgreSQL service with the following command:

systemctl start postgresql

Next, log into the PostgreSQL shell with the following command:

su - postgres
postgres@debian10:~$ psql

Once logged in, you should get the following output:

psql (11.9 (Debian 11.9-0+deb10u1))
Type "help" for help.

Next, create a database and user for the Document server with the following command:

postgres=# CREATE DATABASE onlyoffice;
postgres=# CREATE USER onlyoffice WITH password 'onlyoffice';
postgres=# GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;

Next, exit from the PostgreSQL shell with the following command:

postgres=# EXIT

Next, run exit command again to exit from the Postgres user:


Step 4 – Install ONLYOFFICE Docs

By default, the ONLYOFFICE Docs package is not available in the Debian 10 default repository, so you will need to add the ONLYOFFICE Docs repository to your system.

First, download and add the GPG key with the following command:

mkdir -p -m 700 ~/.gnupg
curl -fsSL | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
chown root:root /tmp/onlyoffice.gpg
mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Next, add the ONLYOFFICE Docs repository with the following command:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] squeeze main" | tee /etc/apt/sources.list.d/onlyoffice.list

Once the repository is added, update the repository with the following command:

apt-get update -y

Next, download and install the ttf-mscorefonts-installer and other packages using the following command.

dpkg -i ttf-mscorefonts-installer_3.8.1_all.deb
apt install x11-common xfonts-encodings libfontenc1 fonts-dejavu-extra cabextract xfonts-utils libcurl4 libxml2 fonts-dejavu fonts-liberation  ttf-mscorefonts-installer fonts-crosextra-carlito fonts-takao-gothic fonts-opensymbol -y

You will get some dependencies error after runnig the above commands. You can fix it with the following command.

apt install -f

Finally, install the ONLYOFFICE Docs with the following command.

apt-get install onlyoffice-documentserver -y

During the installation, you will be asked to provide the password as shown below:

Provide your ONLYOFFICE database password that you have created earlier, then hit Enter to finish the installation:

Setting up onlyoffice-documentserver (5.6.5-3) ...
Generating AllFonts.js, please wait...Done
Generating presentation themes, please wait...Done
Congratulations, the ONLYOFFICE docs has been installed successfully!

ONLYOFFICE creates an Nginx configuration file automatically during the installation. You can check it with the following command:

cat /etc/nginx/conf.d/ds.conf


include /etc/nginx/includes/http-common.conf;
server {
listen [::]:80 default_server;
server_tokens off;

include /etc/nginx/includes/ds-*.conf;

Next, restart the Nginx service to apply the changes:

systemctl restart nginx

Step 5 – Access ONLYOFFICE Docs Web UI

Now, open your web browser and access the ONLYOFFICE Docs web interface using the URL http://your-server-ip. You should see the ONLYOFFICE dashboard on the following screen:

onlyoffice welcome page

onlyoffice welcome page2

To use the integrated test example, a simple doc management system, to check if the editors are running correctly. Run the following command in your terminal.

systemctl start ds-example

Now, click on the GO TO TEST EXAMPLE. You will see your example docs on the following screen.

onlyoffice example doc


Congratulations! You have successfully installed the ONLYOFFICE Docs on Debian 10. You can now integrate ONLYOFFICE Docs API to your website and start editing your documents. For more information, visit the ONLYOFFICE documentation page. Start using ONLYOFFICE on your Alantic.Net VPS Hosting account!

Get started with 12 months of free cloud VPS hosting

Free Tier includes:
G3.2GB Cloud VPS Server Free to Use for One Year
50 GB of Block Storage Free to Use for One Year
50 GB of Snapshots Free to Use for One Year