Sign inSign up

innovarhealthcare/bridgelink-webadmin

By innovarhealthcare

•Updated about 18 hours ago

Image
0

2.1K

innovarhealthcare/bridgelink-webadmin repository overview

A modern web-based administration interface for BridgeLink (Mirth Connect) integration servers. Replaces the Java Swing client with a browser-based UI that runs alongside your existing BridgeLink server.


⁠Images

ImageContents
innovarhealthcare/bridgelink-webadminAll plugins included — open-source plus commercial (SSL Manager, OIDC/SSO, Access Control)
⁠Tags
TagExampleUse for
:latest:latestAlways current
:YYYYMMDD:20260629Pin to a day's build for reproducibility
:sha-<short>:sha-17be68bPin to an exact commit

Platforms: linux/amd64, linux/arm64 (native builds, no QEMU emulation)


⁠Quick start

services:
  bridgelink-webui:
    image: innovarhealthcare/bridgelink-webadmin:latest
    container_name: bridgelink-webui
    ports:
      - "3000:3000"
    environment:
      BRIDGELINK_SERVER_URL: https://your-bridgelink-server:8443
      # Required — accepts the BSL 1.1 license and the BridgeLink WebAdmin
      # Supplemental Terms. See the License section below.
      BL_ACCEPT_LICENSE: "1"
    restart: unless-stopped
docker compose up -d

Open https://localhost:3000 in your browser. The container serves HTTPS by default with a self-signed certificate (see TLS section below).

⁠docker run
docker run -d \
  -p 3000:3000 \
  -e BRIDGELINK_SERVER_URL=https://your-bridgelink-server:8443 \
  -e BL_ACCEPT_LICENSE=1 \
  --name bridgelink-webui \
  innovarhealthcare/bridgelink-webadmin:latest

⁠Environment variables

VariableRequiredDefaultDescription
BRIDGELINK_SERVER_URLYes—URL of the BridgeLink server, e.g. https://server:8443
BL_ACCEPT_LICENSEYes—Must be set to 1 to accept the BSL 1.1 license and the BridgeLink WebAdmin Supplemental Terms. Any other non-empty value is rejected; unset/empty blocks startup.
BRIDGELINK_CA_CERTNo—Path inside the container to a PEM file (CA or self-signed cert) for the BridgeLink TLS hop. When unset, self-signed BridgeLink certs are accepted automatically.
BRIDGELINK_PUBLIC_HOSTNo—Trusted public hostname of this Web UI (e.g. webadmin.example.com). Recommended when deploying without an explicit server allowlist.
PORTNo3000Port the application listens on
SSL_CERT_FILENo/app/certs/server.crtPath inside the container to the TLS certificate for the Web UI
SSL_KEY_FILENo/app/certs/server.keyPath inside the container to the TLS private key for the Web UI
COOKIE_SECURENoautoOverride cookie Secure flag. true forces secure; false disables (for intentional plain-HTTP deployments).

⁠License

BridgeLink Web Administrator is licensed under the Business Source License 1.1 (BSL 1.1) and the BridgeLink WebAdmin Supplemental Terms. Both documents ship inside the image:

  • /app/LICENSE — Business Source License 1.1
  • /app/SUPPLEMENTAL-TERMS.md — BridgeLink WebAdmin Supplemental Terms

Starting the container requires accepting these terms via BL_ACCEPT_LICENSE=1 (see the Environment variables table above). Omitting this variable — or setting it to any value other than 1 — causes the container to print the license terms and exit.


⁠TLS certificates

The container serves HTTPS by default. On first start, the entrypoint script generates a unique self-signed certificate if none is present at SSL_CERT_FILE / SSL_KEY_FILE. Each container instance gets its own key pair.

⁠Bring your own certificate

Mount a host directory containing server.crt and server.key (must be readable by UID 1000):

docker run -d \
  -p 3000:3000 \
  -v /etc/ssl/bridgelink:/app/certs:ro \
  -e BRIDGELINK_SERVER_URL=https://your-server:8443 \
  -e BL_ACCEPT_LICENSE=1 \
  innovarhealthcare/bridgelink-webadmin:latest
⁠Persist the auto-generated certificate across restarts
docker run -d \
  -p 3000:3000 \
  -v bridgelink-certs:/app/certs \
  -e BRIDGELINK_SERVER_URL=https://your-server:8443 \
  -e BL_ACCEPT_LICENSE=1 \
  innovarhealthcare/bridgelink-webadmin:latest

⁠Non-root user

The container runs as the node user (UID 1000, GID 1000). Bind-mounted host directories must be readable by UID 1000:

sudo chown -R 1000:1000 /etc/ssl/bridgelink

Docker named volumes handle ownership automatically.


⁠Updating

docker compose pull && docker compose up -d

Breaking change: This release requires BL_ACCEPT_LICENSE=1 to start (see License above). Existing deployments must add this variable before pulling — otherwise the container exits and restart-loops.

To roll back, pin an older date tag in docker-compose.yml:

image: innovarhealthcare/bridgelink-webadmin:20260628

⁠Support

Tag summary

Content type

Image

Digest

sha256:c52883b70…

Size

100.2 MB

Last updated

about 18 hours ago

docker pull innovarhealthcare/bridgelink-webadmin