Home
Workspace
Installation
Enterprise
Docker
Installing ONLYOFFICE Workspace Enterprise components on separate servers

Installing ONLYOFFICE Workspace Enterprise components on separate servers

Introduction

ONLYOFFICE Workspace Enterprise is a paid version of the collaborative system developed to manage documents, projects, customer relationships, and email correspondence, all in one place.

ONLYOFFICE Workspace Enterprise is shipped as an automatic installation script for Linux operating systems with Docker installed. The script sets up Docker containers with all the components required for ONLYOFFICE Workspace Enterprise correct operation and is easy to run, manage, and update.

You may also want to install ONLYOFFICE Workspace Enterprise components (Document Server, Mail Server and Community Server) on separate servers to balance the load, maintain more granular control over individual components, or for other operational reasons. This guide explains how to install using the provided Docker script.

System requirements

To install ONLYOFFICE Workspace Enterprise components on separate servers, each server must meet the following requirements:

CPU

at least 4-core (6-core recommended)
RAM

at least 8 GB (12 GB recommended)
HDD

at least 40 GB of free space
Additional requirements

at least 6 GB of swap
OS

amd64 Linux distribution with kernel version 3.10 or later
Additional requirements
- Docker: any version supported by Docker team

Although running ONLYOFFICE Workspace Enterprise is resource-intensive, you will not have to allocate swap space before you start installation. When you run the installation script, a 6 GB swap file is created automatically.

Preparing the server for installation

The steps in this section must be performed on each server used for the ONLYOFFICE Workspace Enterprise components installation.

Getting ONLYOFFICE Workspace Enterprise script

Download ONLYOFFICE Workspace Enterprise Docker script file. The script is available on the download page or via the direct link below:

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

Once the download is complete, you can start the installation.

The Docker service is required for ONLYOFFICE Workspace Enterprise to run. The installation script verify that Docker is present and that its version meets the minimum requirement. Otherwise, Docker will be installed or updated automatically.

Docker specifies Google DNS servers by default. If your ONLYOFFICE Workspace Enterprise server is not going to have access to the Internet, it is recommended to change the default Docker DNS address to the address of your local DNS server. To do that, go to the /etc/default/docker file and change the IP address in the following line to the IP address of a DNS server in your local network:

docker_OPTS="--dns 8.8.8.8"

For the RPM based operating systems like CentOS:

Create the /etc/docker/daemon.json configuration file with the following contents:
```
{ "dns" : [ "8.8.8.8" ] }
```
Restart the Docker service:
```
sudo systemctl restart docker.service
```

Installing Document Server

Note that all installation actions must be performed with root privileges.

First, you will need to install Document Server. To do that, run the following command at the first server:

bash workspace-enterprise-install.sh -ics false -ids true -icp false -ims false -es true

This will skip the installation of Mail Server and Community Server and will install Document Server only.

Installing Mail Server

On the second server, proceed with the Mail Server installation. To do that, run the following command:

bash workspace-enterprise-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true

Where yourdomain.com is your own domain that will be used for Mail Server.

Your domain that will be used for maintaining correspondence must be valid and configured for this machine (i.e., it should have the appropriate A record in the DNS settings that points your domain name to the IP address of the machine where Mail Server is installed).
In the command above, the "yourdomain.com" parameter must be understood as a service domain for Mail Server. It is usually specified in the MX record of the domain that will be used for maintaining correspondence. As a rule, the "yourdomain.com" looks like mx1.onlyoffice.com

If you do not have a domain name, you can install ONLYOFFICE Workspace Enterprise without Mail Server. In this case, skip this step and proceed to the Community Server installation.

Installing Community Server with Control Panel

If you run the installation with additional parameters, do not skip the Control Panel installation, as you will not be able to enter your license key once the installation is complete.

The third server will be used to install Community Server together with Control Panel. To do that, run the following command:

bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -mip "mail server ip" -dip "document server ip" -es false

Where document server ip is the IP address of Document Server computer used in the above step and mail server ip is the IP address of Mail Server computer.

If you choose not to install Mail Server, the command should look like this:

bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -dip "document server ip" -es false

This will skip installation and connection of Mail Server.

The command below will display the list of all available script parameters:

bash workspace-enterprise-install.sh -h

For further information on the available script parameters, refer to this article.

Once the installation is finished, you can check ONLYOFFICE Workspace Enterprise for correct work. Open a browser and enter the local network computer IP address (please do not use either localhost or 127.0.0.1 network address for the same computer where you have ONLYOFFICE Workspace Enterprise installed, use its IP address in the local network instead) in the browser address bar. ONLYOFFICE Workspace Enterprise should be up and running, confirming that the installation was successful.