search string side menu

ELMA365 On-Premises > ELMA365 On-Premises Enterprise > Install add-on components for ELMA365 / Install ONLYOFFICE Docs server

Install ONLYOFFICE Docs server

The ONLYOFFICE Docs Server office package, similar to the R7-Office document server, is used for online operations. It includes viewers and editors for text documents, spreadsheets, and presentations. ONLYOFFICE Docs Server is fully compatible with .docx, .xlsx, .pptx formats and allows real-time document editing.

Начало внимание

Prior to installation, register a full domain name and obtain an SSL certificate for it.

Конец внимание

The installation consists of three steps:

  1. Download the Helm chart and configuration file.
  2. Fill out the configuration file.
  3. Install the OnlyOffice chart using Helm in the Kubernetes cluster.

Step 1: Download the Helm chart and configuration file

For installation via the internet, obtain the configuration file values-onlyoffice.yaml by executing the command:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm show values elma365/onlyoffice > values-onlyoffice.yaml

Getting the configuration file for installation in a closed-loop environment without internet access

  1. On a computer with internet access, download the archive of the latest version of the OnlyOffice  chart from the ELMA365 repository by executing the following command:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm pull elma365/onlyoffice

  1. Copy the obtained chart archive onlyoffice-X.Y.Z.tgz to the server where the installation will be performed.
  1. Unpack this chart and copy the default configuration file values.yaml to values-onlyoffice.yaml:

tar -xf onlyoffice-X.Y.Z.tgz
cp onlyoffice/values.yaml values-onlyoffice.yaml

Step 2: Fill out the configuration file

Fill out the configuration file values-onlyoffice.yaml for installing ONLYOFFICE Docs Server.

## onlyoffice settings
onlyoffice:
 ingress:
   ## enable host in ingress
   enabled: true
   className: ""
   annotations:
     kubernetes.io/ingress.class: nginx
   ## annotations for cert-manager opration
   # certmanager.io/cluster-issuer: letsencrypt
   hosts:
     ## Domain (FQDN) through which onlyoffice will be accessible
     - host: example.ru
       paths:
         - path: /
           pathType: ImplementationSpecific
   ## Enable encryption, when using cert-manager, specify secretName letsencrypt
   tls:
     - secretName: elma365-onpremise-tls
       hosts:
         - example.ru
 ## Enable the creation of a secret with your own certificates
 ## Specify the path to the certificate in the lines key: and cert:
 secret:
   enabled: true
   key: "files/my_cert.key"
   cert: "files/my_cert.crt"
 ## Set the value to true when using self-signed certificates for your storage
 unautorizedStorage: false
 ## Number of replicas for high availability
 replicaCount: 1
 ## Enable JWT token usage
 jwtEnabled: false
 ## If a license file is present, set the enable: parameter to true
 ## Specify the path to the license in the line licensePath:
 license:
   enable: false
   licensePath: "files/license.lic"
...

Filling out connection parameters to the private registry for installation in a closed-loop environment without internet access

To connect to the private registry you need to:

  1. Download ELMA365 images and upload them to the local image registry. For more details, see Download ELMA365 images.
  1. Set the address and path for the parameter onlyoffice.image.repository.
  1. Indicate the name of the secret with access rights to the private registry in the parameter onlyoffice.image.pullSecrets. The secret must be created manually and encrypted in Base64.

## onlyoffice settings
onlyoffice:
...
  ## connection parameters to the private registry
  image:
    ## address and path for the private registry
    repository: registry.example.com/onlyoffice/documentserver-ee
    tag: "7.4.0.1"
  ## secret with access rights to the private registry must be manually created, encrypted in Base64
  pullSecrets:
    - myRegistryKeySecretName

where repository format is:

  • address is registry.example.com;
  • path is /documentserver-ee.

Step 3: Install the ONLYOFFICE Docs Server chart using Helm in the Kubernetes cluster

Install the Onlyoffice chart in namespace onlyoffice.

For online installation:

helm upgrade --install onlyoffice elma365/onlyoffice -f values-onlyoffice.yaml -n onlyoffice 

For offline installation without internet access, go to the directory with the downloaded chart and execute the command:

helm upgrade --install onlyoffice ./onlyoffice -f values-onlyoffice.yaml -n onlyoffice

Начало внимание

Installing the ONLYOFFICE Docs Server component does not automatically include the integration of the document server with the ELMA365 application.

After installation, you need to perform the integration of the ONLYOFFICE Docs Server document server with the OnlyOffice module in the ELMA365 application.

For full functionality, purchase a license for ONLYOFFICE Docs Server.

Конец внимание

Delete the ONLYOFFICE Docs Server chart using Helm in the Kubernetes cluster

Начало внимание

Before deleting the ONLYOFFICE Docs Server component, disable the use of the OnlyOffice module in the ELMA365 application.

Конец внимание

To delete the Onlyoffice chart in namespace onlyoffice, execute the command:

helm uninstall onlyoffice -n onlyoffice

install-r7-office.html install-loki.html

Found a typo? Highlight the text, press ctrl + enter and notify us