guideRunning tests using Docker

# Prerequisites

In order to run tests, Docker should be installed.

Running tests using the Docker image is possible for version 3.5.0 or newer.
For older versions we recommend using this approach.

# Running tests

These steps allow you to verify if the application works correctly after the first run or an application update:

  1. Use instructions from the CKEditor Ecosystem customer dashboard to log into the Collaboration Server On-Premises Docker Registry and pull the Docker image.

    docker login -u [user] -p [download_token] [registry]
    docker pull [registry]/cs-tests:[version]
  2. Run tests:

    2.1. Normal mode.

     docker run \
     -e APPLICATION_ENDPOINT="[your_app_endpoint]" \
     -e ENVIRONMENTS_MANAGEMENT_SECRET_KEY="[your_env_management_secret_key]" \

    2.2. Parallel mode – A faster approach. In case of errors we recommend to run tests using the normal mode.

     docker run \
     -e PARALLEL=true \
     -e APPLICATION_ENDPOINT="[your_app_endpoint]" \
     -e ENVIRONMENTS_MANAGEMENT_SECRET_KEY="[your_env_management_secret_key]" \
     [registry]/cs-tests:[version] -- --max-parallel 6
  3. If there are no errors after finishing the tests, the application is ready to use.


  • APPLICATION_ENDPOINT – An endpoint required to communicate with Collaboration Server On-Premises.
  • ENVIRONMENTS_MANAGEMENT_SECRET_KEY – A variable set in the Collaboration Server On-Premises configuration.
  • There is a possibility that some test will not pass. In this case please run the tests again.