Help Center

Switching your ONLYOFFICE DocSpace Enterprise to HTTPS for the Windows version

Introduction

When you install ONLYOFFICE DocSpace Enterprise on Windows, you can use the letsencrypt.org service and script to easily create a CA-signed certificate and switch the portal to HTTPS with a single command.

The article below will explain this can be done.

Creating and installing CA-signed certificate

You need PowerShell version 5.1 or later installed on your computer.

Run Windows PowerShell as administrator. By default, PowerShell is installed at the following path:

C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe

In the PowerShell console, go to the \sbin\ directory. To do that, use the following command:

cd "C:\Program Files (x86)\Ascensio System SIA\DocSpace\sbin"

Run the following script:

./docspace-ssl-setup.ps1 EMAIL DOMAIN

Where:

EMAIL is the email used for registration and recovery contact.
Use comma to register multiple emails, for example: u1@example.com,u2@example.com. User emails must be enclosed in quotes.

Example of a command to run the script:
```
./docspace-ssl-setup.ps1 "EMAIL1,EMAIL2" DOMAIN
```
DOMAIN is the address of the domain where your ONLYOFFICE DocSpace Enterprise portal is installed.

Check A records for your domain (e.g. using the ping command), otherwise the certificate will not be issued.

The script will create and install the CA-signed certificate to your server.

Now your portal should be available via the https:// address.

A task of automatic certificate prolongation will be added to the task scheduler. You will not need to re-run the script when the certificate expires.

Using own certificates

You can use your own certificates via the -f parameter:

./docspace-ssl-setup.ps1 -f CERTIFICATE PRIVATEKEY