Installing ONLYOFFICE Groups using script
STEP 1: Download the installation script file
Execute the following command:
wget https://download.onlyoffice.com/install/install-RedHat.sh
STEP 2: Install ONLYOFFICE Groups
Run the script specifying the -it GROUPS
parameter:
bash install-RedHat.sh -it GROUPS
This will install the ONLYOFFICE Groups solution which includes the ONLYOFFICE Community Server, ONLYOFFICE XMPP Server, and ONLYOFFICE Control Panel components.
Installing ONLYOFFICE Groups manually
Installing dependencies
ONLYOFFICE Community Server uses Mono
(version 6.8 or later), NGINX
, Node.js
(version 12) and mysql-server
as database. Dependencies found in the system repository will be installed automatically at ONLYOFFICE Community Server installation using the yum install command.
Adding the repository containing the up-to-date Mono and XSP package versions (official instructions):
Add the GPG key:
sudo rpm --import "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF"
Add the repository:
su -c "curl https://download.mono-project.com/repo/centos$REV-stable.repo | tee /etc/yum.repos.d/mono-centos$REV-stable.repo"
Change $REV to your OS version manually (6 for versions 6.x, 7 for versions 7.x, 8 for versions 8.x and so on).
We recommend that you use ONLYOFFICE Groups together with Mono version 6.8 or later. You can find out your current version running the mono --version command
Create the /etc/yum.repos.d/nginx.repo
file with the following contents:
[nginx-stable]
name=nginx stable repo
baseurl=https://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true
Change $releasever to your OS version manually (6 for versions 6.x, 7 for versions 7.x, 8 for versions 8.x and so on).
If you are using
CentOS,
firewalld or
SELinux may prevent
NGINX from starting. To avoid this issue you can configure or disable
SELinux as it is described in
this article.
If you prefer or are already using some other MySQL compatible database like MariaDB, you can continue using it. ONLYOFFICE Groups requires MariaDB version 10.1 or later. Please refer to MariaDB website to learn how to install it for your Linux distro.
Go to the package download page using the link. Select the most applicable package list for your OS. Download the package and install it using the yum localinstall command. After running the command the official repository for MySQL 8.0 will be added to your system.
You can add the MySQL 8.0 repository to RHEL 7 using the following succession of commands:
wget https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
sudo yum localinstall mysql80-community-release-el7-3.noarch.rpm
When MySQL server is started, the superuser will be created and a temporary password will be assigned to it. You need to change this password as soon as possible. See the official instructions on that.
Run the command:
curl --silent --location https://rpm.nodesource.com/setup_12.x | sudo bash -
For the search proper work you need to install Elasticsearch v.7.4.0-1. Import the Elasticsearch GPG key:
rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
Create the /etc/yum.repos.d/elasticsearch.repo
file with the following contents:
[elasticsearch]
name=Elasticsearch repository for 7.x packages
baseurl=https://artifacts.elastic.co/packages/7.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md
Elasticsearch requires OpenJDK 8. To install it, use the following command:
sudo yum install java-1.8.0-openjdk-headless
Install Elasticsearch using the following command:
yum install -y elasticsearch-7.4.0-1
Installing ffmpeg
yum -y install epel-release
yum localinstall -y --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$REV.noarch.rpm
yum localinstall -y --nogpgcheck http://rpmfind.net/linux/epel/7/x86_64/Packages/s/SDL2-2.0.10-1.el7.x86_64.rpm
yum -y install ffmpeg ffmpeg-devel
Change $REV to your OS version manually.
Installing mono-webserver-hyperfastcgi
Create the /etc/yum.repos.d/mono-extra.repo
file with the following contents:
[mono-extra]
name=mono-extra repo
baseurl=https://d2nlctn12v279m.cloudfront.net/repo/mono/centos$REV/main/noarch/
gpgcheck=0
enabled=1
Change $REV to your OS version manually.
Install mono-webserver-hyperfastcgi
For CentOS 8:
yum -y install mono-webserver-hyperfastcgi-0.4-7
For CentOS 7:
yum -y install mono-webserver-hyperfastcgi-0.4-6
Installing ONLYOFFICE Groups
Add the yum ONLYOFFICE repository with the following command:
sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm
Install ONLYOFFICE Control Panel:
sudo yum install onlyoffice-controlpanel
Install ONLYOFFICE Community Server:
sudo yum install onlyoffice-communityserver
Install ONLYOFFICE XMPP Server:
sudo yum install onlyoffice-xmppserver
Before you start ONLYOFFICE Groups for the first time it is necessary to create the database and configure connection to it. To do that launch MySQL using the command:
sudo systemctl start mysqld.service
Do not forget to change the default superuser password in case you haven't done it yet. More information on where to view the default password and how to change it is available
here.
And after that run the configuration script:
bash communityserver-configure.sh
This script will interactively ask you to enter the MySQL connection parameters, create the database, update configuration files and run all services.
The script does not create users for the database and does not change passwords for existing users.
After the successful installation ONLYOFFICE Groups will become available at the http://localhost/ address.
If you have encountered some issues while installing
ONLYOFFICE Groups, you can refer to our
Troubleshooting section.