Skip to main content

Switching a Docker installation of ONLYOFFICE Apps Enterprise to HTTPS

Introduction​

When you install ONLYOFFICE Apps Enterprise using Docker, you can use the letsencrypt.org service and script to easily create a CA-signed certificate and switch the workspace to HTTPS with a single command.

The article below will explain how this can be done.

note

When switching to HTTPS, port 443 must be available.

Creating and installing CA-signed certificate​

If you want to install ONLYOFFICE Apps with SSL right away using the letsencrypt certificate, run the installation script with the following parameters:

bash apps-enterprise-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com

Where:

  • letsencryptmail is the email used for registration and recovery contact. Use comma to register multiple emails, for example: u1@example.com,u2@example.com.
  • letsencryptdomain is the address of the domain where your ONLYOFFICE Apps Enterprise workspace is installed. Use comma to register multiple domains, for example: yourdomain1.com,yourdomain2.com.

The script will automatically create and install the letsencrypt.org CA-signed certificate to your server and restart the NGINX service for the changes to take effect.

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

If you want to switch an already installed ONLYOFFICE Apps to HTTPS, read this instruction.

Using own certificates​

If you want to install ONLYOFFICE Apps with SSL right away using your own certificates, run the installation script with the following parameters:

bash apps-enterprise-install.sh docker --appshost yourdomain.com --certfile path --certkeyfile path

Where:

  • appshost is the address of the domain where your ONLYOFFICE Apps Enterprise workspace is installed. Use comma to register multiple domains, for example: yourdomain1.com,yourdomain2.com.
  • certfile is the path to the certificate file for the domain.
  • certkeyfile is the path to the private key file for the certificate.
note

A self-signed certificate must have a full chain to work correctly.

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

If you want to switch an already installed ONLYOFFICE Apps to HTTPS, read this instruction.