Build using Dockerfile

Use this option when you have an installation package (wsc_app_*.tar.gz).

This build creates a custom image. It does not depend on Docker Hub base tags.

What you need

• Docker installed.

• The wproofreader-docker repository version that matches your package version.

• An installation package from support, for example: wsc_app_x64_6.x.x.x_xx.tar.gz.

Keep the package version and the wproofreader-docker release version aligned. The Dockerfile and installer scripts can change between versions.

Prepare the build context

1. Download the wproofreader-docker release that matches your package.

2. Put the package into the repo’s files/ directory.

3. (Optional) Put SSL files into files/certificate/ as:

   • cert.pem

   • key.pem

Build the image

• WPR_LICENSE_TICKET_ID: activates the license during the build.

• WPR_LANGUAGES: comma-separated locales.

• WPR_AI_MODELS: comma-separated AI model IDs.

• WPR_PROTOCOL: 1 (HTTPS) or 2 (HTTP).

• WPR_VIRTUAL_DIR: virtual directory name.

Default value of WPR_VIRTUAL_DIR is wscservice. Set it to / to serve from the root path.

Example:

docker build -t local/wsc_app \
  --build-arg WPR_LICENSE_TICKET_ID=<license_ticket> \
  --build-arg WPR_LANGUAGES=en_US,en_GB,en_CA,en_AU \
  --build-arg WPR_AI_MODELS=1,2 \
  --build-arg WPR_PROTOCOL=2 \
  --build-arg WPR_VIRTUAL_DIR=wscservice \
  -f Dockerfile .

For language short codes, see Supported languages.

Use --env at runtime.

These runtime values override the value used during the image build:

• WPR_PROTOCOL

• WPR_WEB_PORT

• WPR_VIRTUAL_DIR

Full list of runtime options is in the README.

docker run -d \
  -p 80:8080 \
  --env WPR_PROTOCOL=2 \
  --env WPR_WEB_PORT=80 \
  --env WPR_VIRTUAL_DIR=wscservice \
  local/wsc_app

Mount dictionaries and certificates

Mounts are optional. Use them for persistence and for HTTPS.

Persist dictionaries and style guide

Mount /dictionaries to persist shared data outside the container.

It stores:

• User custom dictionaries

• Organization custom dictionaries

• Style Guide data

Use this mount if you:

• recreate containers and need the data to survive

• run several containers and want them to use shared resources

Example:

docker run -d \
  -p 80:8080 \
  -v /path/on/host/dictionaries:/dictionaries \
  local/wsc_app

Use your own TLS certificate

Mount /certificate and provide these files:

• cert.pem

• key.pem

Example (HTTPS):

docker run -d \
  -p 443:8443 \
  -v /path/on/host/certificate:/certificate \
  --env WPR_PROTOCOL=1 \
  --env WPR_WEB_PORT=443 \
  local/wsc_app

The two common endpoints are:

WPR_VIRTUAL_DIR=wscservice

• Version: http(s)://<host>/wscservice/api?cmd=ver

• Status: http(s)://<host>/wscservice/api?cmd=status

WPR_VIRTUAL_DIR=/

Use the checks from the README.

• Health and license time:

  • Health check

• Log-based license validation:

  • License verification

Next steps

• If the target host has no Internet access, continue with Build without internet connection.

• Container options and verification are in the upstream README.