maestrohub/lite repository overview

⁠MaestroHub Lite

The unified data platform that transforms how manufacturing sees, knows, and controls operations.

MaestroHub is an Industrial Context Platform that turns fragmented machine signals (PLCs, SCADA, ERP, sensors) into structured operational context through a single Unified Namespace — connect any industrial system, build data pipelines visually, and create real-time dashboards. No coding required.

maestrohub/lite is the single-container edition: the full platform — Unified Namespace, connectors, visual pipelines, dashboards, built-in MQTT broker, and REST API — in one image. Start with a single binary, scale to Kubernetes when ready.

• Built-in MQTT broker + Unified Namespace
• Web UI + REST API
• Runs as non-root, health-checked, data persisted to a volume

⁠Quick start

Docker

docker run -d \
  --name maestrohub \
  -p 8080:8080 \
  -p 1883:1883 \
  -p 8083:8083 \
  -v maestrohub-data:/data \
  maestrohub/lite:latest

Docker Compose — save as docker-compose.yml:

services:
  maestrohub:
    image: maestrohub/lite:latest
    container_name: maestrohub
    restart: unless-stopped
    ports:
      - "8080:8080"   # Web UI + REST API
      - "1883:1883"   # MQTT broker
      - "8083:8083"   # MQTT over WebSocket
    volumes:
      - maestrohub-data:/data
volumes:
  maestrohub-data:

docker compose up -d

Then open http://localhost:8080⁠ and create your admin account on the first-login screen (name, email, password — there are no default credentials). You are logged in immediately.

⁠Ports

⁠Data & persistence

Application data lives in /data. Mount a named volume (as shown above) to keep it across restarts and upgrades. The image runs as a non-root user, so a named volume is recommended over a bind mount — ownership is then initialized correctly.

⁠Health

A health check is built in. Verify manually:

curl http://localhost:8080/health

Returns per-module status as JSON.

⁠Useful commands

docker logs -f maestrohub     # follow logs
docker stop maestrohub        # stop (data preserved)
docker start maestrohub       # start again

⁠Upgrade

docker compose pull && docker compose up -d

Your data is preserved in the maestrohub-data volume.

⁠Requirements

• Architectures: amd64, arm64
• Minimum: 2 CPU cores, 2 GB RAM, 20 GB disk — recommended 8 cores / 16 GB / 200 GB+ for production
• OS: Windows 10/11, macOS 12+, Linux (Ubuntu 20.04+, Debian 11+, RHEL 8+)

⁠Tags

Use maestrohub/lite:latest for the newest release, or pin a specific version (e.g. maestrohub/lite:2.6.0) for reproducible and production deployments. See the Tags tab for all available versions.

MaestroHub · Maestrohub Yazılım A.Ş. · maestrohub.com⁠ · docs.maestrohub.com⁠