iconics/webhmi repository overview

⁠GENESIS WebHMI

This Docker image contains the WebHMI server module for GENESIS. WebHMI delivers zero-install, browser-based HMI/SCADA visualization, allowing operators to view and interact with GraphWorX displays from any modern web browser without a local client.

The image runs anywhere Docker runs—from a single container on a workstation or server, to a horizontally scalable workload on Kubernetes. Each container runs a WebHMI instance that connects to one or more FrameWorX servers. When deployed to Kubernetes, you increase the replica count as client demand grows and Kubernetes distributes the load across the available nodes—delivering consistent performance, automatic recovery, and rolling updates for large numbers of concurrent users.

⁠Features

• Browser-based visualization — Serves GraphWorX displays and live process data to any modern web browser; no client installation required.
• Runs anywhere Docker runs — Start a single container for evaluation or small deployments with docker run.
• Horizontal scaling — On Kubernetes, run as many WebHMI pods as needed and spread client load across multiple nodes.
• High availability — On Kubernetes, failed pods are automatically restarted and rescheduled onto healthy nodes.
• FrameWorX connectivity — Connects to one or more pre-defined FrameWorX servers.
• OpenID Connect (OIDC) authentication — Supports stateless OIDC tokens so user sessions survive pod failover and relocation without re-authentication.
• Custom display mounting — Make your own displays available to all instances through a Docker volume, or—on Kubernetes—through NFS, SMB, Azure File, an existing PersistentVolumeClaim, or a host path.
• TLS termination — Designed to run behind an ingress controller or reverse proxy with HTTPS and a TLS certificate for secure client connections.

⁠About GENESIS

GENESIS is Mitsubishi Electric Iconics Digital Solutions' advanced HMI/SCADA platform for real-time visualization, data connectivity, alarming, and analytics across industrial and building automation systems. WebHMI is the web-based visualization client of GENESIS, rendering GraphWorX displays and live data to standard web browsers on desktop and mobile devices.

For more information about the platform, see https://iconics.com⁠.

⁠Quick Start — Docker

Run a single WebHMI container and point it at your FrameWorX server:

docker run -d --name webhmi -p 8080:8080 \
  -e ICO_Client__DefaultConnection__Url="ws://genesis-vm:80/fwxserverws/ws_anon/" \
  -e ICO_TRACE_OVERRIDE=stdout@notice \
  iconics/webhmi:latest

Replace genesis-vm with the hostname or IP address of your GENESIS (FrameWorX) server, then open http://localhost:8080 in your browser. If FrameWorX runs on the same host as Docker, use host.docker.internal as the hostname instead of localhost.

⁠Quick Start — Kubernetes

For production and large-scale deployments, WebHMI is deployed to Kubernetes using the ICONICS Helm chart, which provisions the WebHMI pods together with the ingress controller and supporting resources.

# Add the ICONICS Helm repository
helm repo add ico https://download.iconics.com/helm-charts/
helm repo update

# Install or upgrade the WebHMI release using your values file
helm upgrade -i ico ico/webhmi -f values.yaml

A minimal values.yaml:

# values.yaml

# Not necessary for a public image. Uncomment the following line if needed.
# imagePullSecret: dockerhub-secret

frameworx:
  servers:
  - genesis-vm  # Change to the DNS name of the Genesis machine

replicaCount: 3

logging:
  level: notice  # Possible values: all, debug, info, notice, warning, error, fatal

ingress:
  host: webhmi.example.com  # Change to the DNS name of the cluster
  useHttps: true
  tlsSecretName: webhmi-tls

metallb:
  enabled: true
  address: 1.2.3.4  # Change to the IP of the cluster

# CoreDNS will be installed if 'coredns.enabled' is set to 'true'.
# If CoreDNS is already installed in your cluster, set this to 'false' or remove this section.
coredns:
  enabled: true

Full deployment documentation is available here⁠

⁠License and Legal Notice

The software contained in this Docker image container is licensed under the terms of the Mitsubishi Electric Iconics Digital Solutions License Agreement⁠