Export to Word On-Premises installation

# Setting up the application using a Docker container

1. Use instructions from the CKEditor Ecosystem customer dashboard to log into the Export to Word On-Premises (DOCX converter) Docker registry and pull the Docker image.

2. Containerize the application using docker or docker-compose.

3. Use a demo page to verify if the application works properly.

# Containerize example using docker

Launch the Docker container:

docker run --init -p 8080:8080 -e LICENSE_KEY=[your_license_key] docker.cke-cs.com/docx-converter:[version]

If you want use authorization you should provide SECRET_KEY:

docker run --init -p 8080:8080 -e LICENSE_KEY=[your_license_key] -e SECRET_KEY=[your_secret_key] docker.cke-cs.com/docx-converter:[version]

You can read more about using authorization in the authorization section.

# Containerize example using docker-compose

1. Create the docker-compose.yml file:

version: "3.8"
  services:
    image: docker.cke-cs.com/docx-converter:[version]
      ports:
        - "8000:8000"
      restart: always
      init: true
      environment:
        LICENSE_KEY: your_license_key
        # Secret Key is optional
        SECRET_KEY: secret_key

For details on SECRET_KEY usage check the authorization section.

2. Run:

docker-compose up

# Notes

• Without a correct LICENSE_KEY the application will not start. If the license is invalid, you’ll get a Wrong license key error in the logs and the application will not run.
• You should override the SECRET_KEY variable using a unique and hard to guess string for security reasons.

# Testing with the demo page

After installing Export to Word On-Premises you can verify the installation by using the demo page.
The page is available on http://localhost:[port]/demo (by default the port is 8080).
You can modify the content as needed or leave the default one.

After pressing the “Create a DOCX” button a DOCX document should be generated.