Installation with Debian based distributives also requires the presence of libstdc++6, NGINX and PostgreSQL in the system.
All the necessary instrutions for these components and their dependencies installation can be found at their official websites.
There are other dependencies installed together with ONLYOFFICE Docs:
- libcurl3
- libxml2
- fonts-dejavu
- fonts-liberation
- ttf-mscorefonts-installer
- fonts-crosextra-carlito
- fonts-takao-gothic
- fonts-opensymbol
These dependencies are installed automatically when you use Ubuntu 14.04 LTS or later. Earlier distributions might require their manual installation.
Installing dependencies
ONLYOFFICE Docs uses NGINX and PostgreSQL as database. Dependencies found in the system repository will be installed automatically at ONLYOFFICE Docs installation using the apt-get install command.
Installing and configuring PostgreSQL:
Install the PostgreSQL version included in your version of Ubuntu:
sudo apt-get install postgresql
After PostgreSQL is installed, create the PostgreSQL database and user:
The database user must have the onlyoffice name. You can specify any password.
sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
Installing redis:
sudo apt-get install redis-server
Installing rabbitmq:
sudo apt-get install rabbitmq-server
Ubuntu distributives prior to 14.04 LTS might require some other dependencies to be installed.
Ubuntu 18.04 will require to install nginx-extras. This is done using the command:
sudo apt-get install nginx-extras
Changing the default ONLYOFFICE Docs port
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.
If you are going to change the default port, make sure that it is open for the incoming/outgoing connections. See the
complete list of the ports used by
ONLYOFFICE Docs.
To do that you will need to change the default port for the debconf system, running the command:
echo onlyoffice-documentserver-ee onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections
echo onlyoffice-documentserver-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections
Please write the port number instead of the <PORT_NUMBER> in the above command.
Warning
If you want to change the
ONLYOFFICE Docs protocol to HTTPS, do not change the port to
443, but use
this instruction instead.
There are additional options which can be used for ONLYOFFICE Docs installation. Please read this section for more information on them.
After that you can continue with ONLYOFFICE Docs installation.
Installing ONLYOFFICE Docs
Add GPG key:
mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg
Add ONLYOFFICE Docs repository:
echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
While the APT package is built against Debian Squeeze, it is compatible with a number of Debian derivatives (including Ubuntu) which means you can use the same repository across all these distributions.
When installing ONLYOFFICE Docs on Debian, add the contrib component to /etc/apt/sources.list. To learn more, you can refer to the Debian documentation.
Update the package manager cache:
sudo apt-get update
Install mscorefonts:
sudo apt-get install ttf-mscorefonts-installer
Install ONLYOFFICE Docs
sudo apt-get install onlyoffice-documentserver-ee
sudo apt-get install onlyoffice-documentserver-de
During the installation process, you will be asked to provide a password for the onlyoffice PostgreSQL user. Please enter the onlyoffice password that you have specified when configuring PostgreSQL.
After that ONLYOFFICE Docs will be run as a process. The package will be updated just like any other deb package.
Now 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.