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

Installing ONLYOFFICE Workspace Community using the provided script

Introduction

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

ONLYOFFICE Workspace Community 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 Community correct work and is easy to run, manage and update.

This guide explains how to install ONLYOFFICE Workspace Community on your server. Alternatively, you can run this script and select an option to install ONLYOFFICE Workspace Community 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

Although running ONLYOFFICE Workspace Community 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.

Getting ONLYOFFICE Workspace Community script

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

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

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

Running complete installation of ONLYOFFICE Workspace Community

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

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

bash workspace-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 Community for your local server, you can install it without ONLYOFFICE Mail.

The Docker service is required for ONLYOFFICE Workspace Community to run. The installation script will 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 Community 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
```

Running ONLYOFFICE Workspace Community installation without ONLYOFFICE Mail

If you do not wish to install ONLYOFFICE Mail at this stage, you can skip its installation. To do that, run the following command:

bash workspace-install.sh -ims false

This will install ONLYOFFICE Workspace Community without ONLYOFFICE Mail.

The list of all available script parameters is available with the below command:

bash workspace-install.sh -h

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

Once the installation is finished, you can verify that ONLYOFFICE Workspace Community is running correctly. 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 Community installed, use its IP address in the local network instead) in the browser address bar. ONLYOFFICE Workspace Community should be up and running, confirming that the installation was successful.