introduction
The Enterprise edition allows you to install ONLYOFFICE documents on your local server and integrate the online editor with ONLYOFFICE collaboration platforms or other popular systems. This article will introduce in detail the process of installing OnlyOffice Community Edition on a Windows server, and I hope it will be helpful to everyone.
ONLYOFFICE Docs is an online office suite including viewers and editors for text, spreadsheets and presentations, fully compatible with office Open XML formats: .docx, .xlsx and .pptx, and supports real-time collaborative editing.
System Requirements:
-
OS 64-bit Windows Server 2012 or later
-
Erlang: Version 24.2
-
RabbitMQ: Version 3.9.12
-
Redis: Version 5.0
-
PostgreSQL: Version 12.9 or later
prerequisites
To install the prerequisites, download and install the following components:
-
Erlang (download address: https://erlang.org/download/otp_win64_24.2.exe)
-
RabbitMQ (download address: https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.9.12/rabbitmq-server-3.9.12.exe)
-
Redis (community version does not need to install Redis)
-
PostgreSQL (download address: https://www.postgresql.org/download/windows/)
Download the installation kit and install accordingly.
Generally, for the exe execution file in this case, it is recommended that everyone right-click ---> run as administrator.
1. Install Erlang
Select the components to be installed, as shown in the figure below:
Select the Erlang installation directory, as shown in the following figure:
Depending on the situation during the installation process, the C++ compilation environment may be automatically installed, as shown in the following figure:
Just wait for the installation to complete.
2. Install RabbitMQ
Select the components to be installed (select all), as shown in the following figure:
Wait for the installation to complete, as shown in the figure below:
3. Install Redis (the community version does not need to install Redis, the enterprise version needs to install Redis)
The installation is relatively simple, just install it in the next step, so I won’t go into details here.
4. Install PostgreSQL
Click Next, we set the password as: 123456
The database password needs to be kept in mind, and it will be used when installing OnlyOffice in the future
The installation is relatively simple, just install it in the next step:
Select the application to be installed, here we choose PostgreSQL (64 bit) v15.0-1, as shown in the figure below:
Confirm the components to be installed and specify the download directory:
After downloading and installing, click Next until the installation is complete.
pgAdmin use
We can create and manage databases using the pgAdmin tool or command prompt.
1. Run the command:
"C:Program FilesPostgreSQLpgAdmin 4inpgAdmin4.exe"
2. Enter the initial password: 123456
create user
Create user: onlyoffice (password is also onlyoffice)
set user password
Switch to the Definitions tab and enter onlyoffice in the Password field.
Go to the "Permissions" tab and click "Can I log in?"
Switcher set to "Yes" value
Click the "Save" button to save the settings for user permissions.
Create a database:
Create a new database named onlyoffice, and the Owner selects the onlyoffice user we just created, as shown in the following figure:
So far, the prerequisites for installing OnlyOffice have been met. Below we begin to install the OnlyOffice server.
5. Install ONLYOFFICE Docs
Download OnlyOffice Docs Community Edition, download address: Download ONLYOFFICE Docs | ONLYOFFICE
Select the appropriate installer version: For Windows Server2012 and above (64-bit only)
Reminder: the onlyoffice installation program will use port 80 as the default access port by default. If the server is opened and similar applications such as IIS have already occupied port 80, the onlyoffice server may fail to start. We installed OnlyOffice in the C:\Program Files directory, but it seems that port 80 cannot be enabled normally. At this point, we need to uninstall the previous installation and specify the new port when executing the installer.
The error message in the Nginx log (C:/Program Files/ONLYOFFICE/DocumentServer/Log/nginx) is as follows:
The process of uninstalling OnlyOffice can be carried out as follows:
To uninstall an existing installation of OnlyOffice:
Directly execute C:/Program Files/ONLYOFFICE/Documenterver/unins000.exe to uninstall the program, as shown in the figure below:
After waiting for a while, the system will complete the uninstallation of OnlyOffice for us, as shown in the figure below:
Start the OnlyOffice installer:
1. If you use port 80 as the default port, you can directly double-click the installation program onlyoffice-documentserver.exe to install
2. If you need to use other ports as the default port, you can add parameters to specify the default port when executing the installation program onlyoffice-documentserver.exe. The steps are as follows:
By default, ONLYOFFICE Docs uses port 80 to listen for incoming connections. Since version 4.3, you can change the port if you intend to use the port of ONLYOFFICE Docs instead of the default port. To do this, run the executable with the following parameters:
onlyoffice-documentserver-ee.exe /DS_PORT=<PORT_NUMBER>
where <PORT_NUMBER> is the port number you want ONLYOFFICE documents to use.
1) Use PowerShell to enter the directory where the installer is located:
2) Execute the command in the PowerShell window to start the OnlyOffice installation program, as shown in the figure below (the number after the DS_PORT parameter is the port number we need to use):
.onlyoffice-documentserver.exe /DS_PORT=8080
Detailed installation process of OnlyOffice
Specify the OnlyOffice server installation directory:
We specify C:/Program Files/ONLYOFFICE/DocumentServer
1) Configure database ( PostgreSQL ) connection connection information :
-
-
Host : localhost (database server IP or domain name)
-
User : onlyoffice (user account)
-
Password : onlyoffice (user password)
-
Database : onlyoffice (database name)
-
2) Configure RabbitMQ server connection information :
-
-
Host : localhost (RabbitMQ server IP)
-
User : guest (user account)
-
Password : guest (user password)
-
After the installation is complete, the interface as shown in the figure below.
After clicking Finish, the system will pop up a browser to access the example page to verify whether the installation is successful: http://localhost:8080/example
According to the requirements of the example page, start the example server, and execute the command as shown below:
net start DsExampleSvc
Execute the command in any directory to start the Example server, as shown below:
If you need the server to start automatically, you can execute the command:
sc config DsExampleSvc start=auto
Click the Go to Test Example button to jump to the demo page:
At this point, the OnlyOffice server installation is complete! For the configuration between O2OA and OnlyOffice, please refer to the following articles:
"Office Online Collaboration (2) - Download and Install O2OA Server For Windows Server 2019"