Home
Workspace
Installation
Enterprise
Docker
Installing ONLYOFFICE Workspace Enterprise using the provided script

Installing ONLYOFFICE Workspace Enterprise using the provided script

Introduction

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

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

This guide will show you how to install ONLYOFFICE Workspace Enterprise Edition to your machine using the provided Docker script. Alternatively, you can run this script and select an option to install ONLYOFFICE Workspace Enterprise Edition from RPM/DEB packages.

System 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

Though running ONLYOFFICE Workspace Enterprise Edition is a very resourceful operation, 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.

Getting ONLYOFFICE Workspace Enterprise Edition script

Download ONLYOFFICE Workspace Enterprise Edition Docker script file. You can do that using our site download page. Or the direct download link can be used, if it is more convenient for you:

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

Once the download is finished, you can start the installation process.

Running complete installation of ONLYOFFICE Workspace Enterprise Edition

Please note that all installation actions must be performed with root rights.

You can install all ONLYOFFICE Workspace Enterprise Edition components and modules at once. To do that, run the following command:

bash workspace-enterprise-install.sh -md "yourdomain.com"

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

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 ONLYOFFICE Mail 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 or simply want to install ONLYOFFICE Workspace Enterprise Edition for your local server, you can install it without ONLYOFFICE Mail. In case you plan to add it later, you will be able to do that from Control Panel.

For the ONLYOFFICE Workspace Enterprise Edition to be able to run the Docker service is necessary. The installation script will check if it is present on the computer and its version is not less than the minimal required. Otherwise, the Docker will be installed or updated automatically.

Docker specifies Google DNS servers by default. If your ONLYOFFICE Workspace Enterprise Edition server is not going to have access to the Internet, we recommend that you 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
```

Running ONLYOFFICE Workspace Enterprise Edition installation without ONLYOFFICE Mail

In case you do not want to install ONLYOFFICE Mail just now, you can skip its installation. To do that, run the following command:

bash workspace-enterprise-install.sh -ims false

This will install ONLYOFFICE Workspace Enterprise Edition without ONLYOFFICE Mail. You can add it later from Control Panel, please read the this article to learn how this can be done.

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

bash workspace-enterprise-install.sh -h

If you choose to run the installation with some additional parameters, please do not skip Control Panel installation, otherwise you will not be able to enter your license key after the installation is finished and add, for instance, ONLYOFFICE Mail to your ONLYOFFICE Workspace Enterprise Edition instance.

To learn more on how to use all the available script parameters, please refer to this article.

Once the installation is finished, you can check ONLYOFFICE Workspace Enterprise Edition 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 Edition installed, use its IP address in the local network instead) in the browser address bar. ONLYOFFICE Workspace Enterprise Edition must be up and running, indicating the successful installation.

Host ONLYOFFICE Workspace on your own server

Download