Installing ONLYOFFICE Docs Developer Edition for CentOS and derivatives

• CPU
  dual core 2 GHz or better
• RAM
  at least 2 GB, but depends of the host OS. More is better
• HDD
  at least 40 GB of free space
• SWAP
  at least 4 GB, but depends of the host OS. More is better
• OS
  RHEL 7, 8, 9 or CentOS 7, 8 Stream, 9 Stream
• Additional requirements
  • PostgreSQL: version 12.9 or later
  • NGINX: version 1.3.13 or later
  • Redis: version 4 or later
  • RabbitMQ: version 3.13

Installing the up-to-date NGINX package version

To set up the yum repository for RHEL/CentOS, create the file named /etc/yum.repos.d/nginx.repo with the following contents:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Official instruction

Install NGINX:

sudo yum install nginx

After that edit the /etc/nginx/nginx.conf NGINX configuration file, so that it looked the following way:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}

Installing EPEL repository

sudo yum install epel-release

Installing and configuring PostgreSQL

Install the PostgreSQL version included in your version of CentOS:

sudo yum install postgresql postgresql-server

Initialize the PostgreSQL database

sudo service postgresql initdb 
sudo chkconfig postgresql on

Turn on the 'trust' authentication method for IPv4 and IPv6 localhost

Open the /var/lib/pgsql/data/pg_hba.conf file in a text editor.

Find the host all all 127.0.0.1/32 ident string and replace it with the following one:

host    all             all             127.0.0.1/32            trust

Then find the host all all ::1/128 ident string and replace it with the following one:

host    all             all             ::1/128                 trust

Save the changes.

Restart the PostgreSQL service:

sudo service postgresql restart

Create the PostgreSQL database and user:

First run the command

cd /tmp

to prevent the could not change directory to "/root" warning if running from root. Then the database and the user must be created:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

sudo yum install redis

sudo service redis start
sudo systemctl enable redis

Installing RabbitMQ

sudo yum install rabbitmq-server

To install RabbitMQ on CentOS 8, please refer to the official instruction.

Start the rabbitmq service and enable start on boot:

sudo service rabbitmq-server start
sudo systemctl enable rabbitmq-server

Installing mscorefonts

Install the cabextract and xorg-x11-font-utils packages:

sudo yum install cabextract xorg-x11-font-utils

For CentOS 7.8(2003), fontconfig is also required:

sudo yum install fontconfig

Install the msttcore fonts package:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

Adding the ONLYOFFICE Docs repository

Add the yum ONLYOFFICE Docs repository with the following command:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

Installing ONLYOFFICE Docs

Execute the following command:

sudo yum install onlyoffice-documentserver

sudo yum install onlyoffice-documentserver-ee

sudo yum install onlyoffice-documentserver-de

Run dependent services and enable start of them on boot:

sudo service nginx start
sudo systemctl enable nginx

After that ONLYOFFICE Docs will be run as a process. The package will be updated just like any other rpm package.

By default ONLYOFFICE Docs listens to the incoming connections using port 80. Starting with version 4.3 you can change the port for ONLYOFFICE Docs if you plan to use it instead of the default one.

To do that you will need to edit the DS_PORT environment variable running the command:

export DS_PORT=<PORT_NUMBER>

Please write the port number instead of the <PORT_NUMBER> in the above command.

After that you can continue configuring ONLYOFFICE Docs.

Run a configuration script

Run the documentserver-configure.sh script:

bash documentserver-configure.sh

You will be asked to specify the PostgreSQL, Redis and RabbitMQ connection parameters. Use the following data:

For PostgreSQL:

• Host: localhost
• Database: onlyoffice
• User: onlyoffice
• Password: onlyoffice

For RabbitMQ:

• Host: localhost
• User: guest
• Password: guest

Add a firewall exception

sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload

Disable SELinux deprecated since v.5.0

Open the /etc/selinux/config file using any text editor, replace the SELINUX=enforcing or SELINUX=permissive string with the SELINUX=disabled one and save the changes.

Reboot your server for the changes to take effect.

Once the configuration is finished, you can enter http://localhost in your browser address bar to open the ONLYOFFICE Docs welcome page where you will find further instructions on how to enable document examples or integrate online editors into your web application using the provided API.

To connect ONLYOFFICE Docs to ONLYOFFICE Groups, please refer to this instruction.