meddream/mdstatistics repository overview

⁠mdstatistics — MedDream viewer performance dashboard

A small, self-contained web app that reads a MedDream telemetry database (MySQL or PostgreSQL) and shows study-opening performance as an expandable timeline browser: the latest opens, newest first, each drawn as a multi-lane timeline of the startup/loading phases and expandable into per-series queue-wait → download → decode lines. Search, per-column sorting, modality / date / version / study-role filters, and a client-side time-window zoom sit above the list.

⁠Quick start

docker run -d --name mdstatistics -p 8050:8050 \
  -e MDSTATS_DB_TYPE=postgresql \
  -e MDSTATS_DB_HOST=db.example -e MDSTATS_DB_NAME=mdstatistics \
  -e MDSTATS_DB_USER=stats -e MDSTATS_DB_PASSWORD=secret \
  meddream/mdstatistics:latest

Then open http://localhost:8050⁠.

⁠docker compose

services:
  mdstatistics:
    image: meddream/mdstatistics:latest
    restart: unless-stopped
    ports:
      - "8050:8050"
    environment:
      MDSTATS_DB_TYPE: postgresql
      MDSTATS_DB_HOST: postgres          # e.g. the database service name
      MDSTATS_DB_NAME: mdstatistics
      MDSTATS_DB_USER: ${MDSTATS_DB_USER}
      MDSTATS_DB_PASSWORD: ${MDSTATS_DB_PASSWORD}
      MDSTATS_AUTH_ENABLED: "1"
      MDSTATS_AUTH_USERNAME: ${MDSTATS_AUTH_USERNAME}
      MDSTATS_AUTH_PASSWORD: ${MDSTATS_AUTH_PASSWORD}
      MDSTATS_AUTH_SECRET_KEY: ${MDSTATS_AUTH_SECRET_KEY}

⁠Configuration (environment variables)

Notes:

• The container already listens on 0.0.0.0 inside, so there is no need to set MDSTATS_HOST.
• Enable authentication (MDSTATS_AUTH_*) for any internet-facing deployment, and set a fixed MDSTATS_AUTH_SECRET_KEY.
• The app only reads the database; it never writes to it.

⁠Ports

• 8050/tcp — the web UI (override with MDSTATS_PORT).