Home
Workspace
Installation
Community
Linux
Installing ONLYOFFICE Workspace Community from RPM/DEB packages using the provided script

Installing ONLYOFFICE Workspace Community from RPM/DEB packages 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 can be installed using an automatic installation script for Linux operating systems. The script will set up all the components necessary for ONLYOFFICE Workspace Community correct work and is easy to run, manage and update.

This guide explains how to install ONLYOFFICE Workspace Community to your machine using RPM/DEB packages with the help of the provided script. This installation method allows you to install ONLYOFFICE Docs, ONLYOFFICE Community Server, ONLYOFFICE Control Panel, and ONLYOFFICE Talk at once, without ONLYOFFICE Mail which can be installed later. Alternatively, you can run this script and select an option to install ONLYOFFICE Workspace Community using Docker.

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 a very 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 installation script file. The script is available on the download page or via the direct link below:

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

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

Running ONLYOFFICE Workspace Community installation

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

To start the installation process run the following command:

bash workspace-install.sh

Once you enter the above command, you will be prompted to select the way you want to install ONLYOFFICE Workspace. Type N and press Enter to install ONLYOFFICE Workspace Community using RPM/DEB packages.

If some programs already installed on your machine are using ports required for ONLYOFFICE Workspace Community, you will be asked to verify that the required ports are free. To find out which application is using a specific port, run the following command:

netstat -lnp | grep :<port_number>

You can then reconfigure the application to use a different port. Once the required ports are free, rerun the script and select the RPM/DEB installation option.

The script will automatically install and configure all required prerequisites as well as the ONLYOFFICE Workspace Community components (ONLYOFFICE Docs, Control Panel and ONLYOFFICE Workspace).

If you are using CentOS, SELinux may prevent NGINX from starting. To avoid this issue you can configure or disable SELinux as it is described in this article.

Once the installation is complete, you can verify that ONLYOFFICE Workspace Community is running correctly. Open a browser and enter the local network computer IP address (do not use localhost or 127.0.0.1; enter the machine's IP address on the local network in the browser address bar instead. ONLYOFFICE Workspace Community should be up and running, confirming that the installation was successful.

If you install ONLYOFFICE Workspace Community using RPM/DEB packages, the HTTPS and Update sections will not be available in the Control Panel and you will need to manually install ONLYOFFICE Mail and connect it to ONLYOFFICE Workspace Community. In this case, refer to the corresponding instructions to install and connect ONLYOFFICE Mail.

When installing ONLYOFFICE Workspace Community some values are stored in debconf and are used during subsequent updates. For example, database connection parameters.

If these parameters are changed manually in the configuration files, an error will occur during updates. To prevent this, update the parameters in debconf using the following commands:

echo "onlyoffice-communityserver onlyoffice-communityserver/db-host select Newhost" | debconf-set-selections
echo "onlyoffice-communityserver onlyoffice-communityserver/db-user select Newuser" | debconf-set-selections
echo "onlyoffice-communityserver onlyoffice-communityserver/db-name select Newname" | debconf-set-selections
echo "onlyoffice-communityserver onlyoffice-communityserver/db-pwd password Newpassword" | debconf-set-selections
echo "onlyoffice-xmppserver onlyoffice-xmppserver/db-host select Newhost" | debconf-set-selections
echo "onlyoffice-xmppserver onlyoffice-xmppserver/db-user select Newuser" | debconf-set-selections
echo "onlyoffice-xmppserver onlyoffice-xmppserver/db-name select Newname" | debconf-set-selections
echo "onlyoffice-xmppserver onlyoffice-xmppserver/db-pwd password Newpassword" | debconf-set-selections

Other ways to install ONLYOFFICE Workspace Community using RPM/DEB packages

When you run the workspace-install.sh script and select "N", this triggers the additional installation script for RPM/DEB packages: install-RedHat.sh/install-Debian.sh depending on your operating system. You can also download and run this script directly, with additional parameters if needed. The available commands are listed below.

For RedHat

Get the installation script:

wget https://download.onlyoffice.com/install/install-RedHat.sh

Install ONLYOFFICE Workspace Community using RPM packages:
```
bash install-RedHat.sh -it WORKSPACE
```
Display available script parameters:
```
bash install-RedHat.sh -h
```
Update existing ONLYOFFICE Workspace Community components using RPM packages:
```
bash install-RedHat.sh -u true -it WORKSPACE
```

For Debian

Get the installation script:

wget https://download.onlyoffice.com/install/install-Debian.sh

Install ONLYOFFICE Workspace Community using DEB packages:
```
bash install-Debian.sh -it WORKSPACE
```
Display available script parameters:
```
bash install-Debian.sh -h
```
Update existing ONLYOFFICE Workspace Community components using DEB packages:
```
bash install-Debian.sh -u true -it WORKSPACE
```