Information

  • The web client comes with its own docker image.
  • The docker image can be made available where there is a docker installation or a compatible container runtime.
    • This includes Windows computers, although the web client image is based on Linux.
  • For production workloads we recommend that you set up PLANTA secure as a reverse proxy (TLS scheduling, single sign-on with OIDC, etc.).
  • Here is a description of deployment via docker compose:

Download the Web Client Container

Procedure

  • The image is available on the PLANTA registry under registry.planta.services (web interface under https://registry.planta.services). The login data will be sent to you by PLANTA upon request.

Configure the Web Client Container with Docker-Compose

Procedure

  • The configuration of the web client can be made via environment variables (docker-compose.yml, "Environment") section.
  • Port mapping (docker-compose.yml, "Ports” section)
  • Artifact version (docker-compose.yml, "Image" section) corresponds to the docker-image namen + day, e.g. registry.planta.services/planta/webclient:latest.


Example docker-compose.yml

version: "3.3"

services:
  webclient:
    image: registry.planta.services/planta/webclient:latest # Artifact Version
    environment:
      - "ConnectionSettings__Servers__0__Host=production.planta.de"  # PLANTA Server Host
      - "ConnectionSettings__Servers__0__Port=20001" # PLANTA Server Port
    ports:
      - "8080:5000" # "[free port]:5000 (default port of the webclient)"
YML

Make the Web Client Container Available with Docker-Compose

Procedure

  1. Edit the configuration.
  2. (If there is no image yet) Log on to the registry using the usual login data: docker login registry.planta.services.
  3. (If there is no image yet) Drag the docker image: docker-compose pull.
  4. Log off from the registry: docker logout registry.planta.services.
  5. Create or start container: docker-compose up -d.

Command Line Commands

  • Stop container: docker-compose stop
  • Stop or delete container: docker-compose down
  • View logs: docker-compose logs