The United Manufacturing Hub (UMH) is an open-source solution for ingesting, contextualizing, and storing factory data. It helps you quickly build a Unified Namespace for your production lines—laying the foundation for advanced analytics, real-time monitoring, and digital transformations.

This repository contains:

• UMH Core (in the umh-core folder) – our new, lightweight single-container approach.
• Helm Chart (in deployment/united-manufacturing-hub) – the classic Kubernetes installation method for a full-stack, scalable setup.

UMH Core is a single-container, Docker-based edge gateway that bundles:

• Agent – a small Go control-loop that reads /data/config.yaml, watches health, and talks to the UMH Management Console on management.umh.app.
• Benthos-UMH – a high-throughput streaming engine; every pipeline you define is called a Data Flow Component (DFC).
• Redpanda – a Kafka-compatible broker that buffers data locally whenever the network blinks.

Deploy UMH Core on any device that runs Docker (Raspberry Pi, industrial PC, cloud VM – no Kubernetes required).

sudo docker run -d \
  --restart unless-stopped \
  -v $(pwd)/umh-core-data:/data \
  -e AUTH_TOKEN=YOUR_TOKEN_HERE \
  -e RELEASE_CHANNEL=stable \
  -e LOCATION_0="My-Plant---Line-A" \
  -e API_URL=https://management.umh.app/api \
  management.umh.app/oci/united-manufacturing-hub/umh-core:latest

• Connect to the cloud console:
  1. Go to management.umh.app
  2. Follow the Add Instance steps to add a new UMH Core instance

For more details on using UMH Core, see our website, see the README, or sign in to management.umh.app.

The Helm chart in deployment/united-manufacturing-hub provides the original, full-stack “UMH Classic” deployment for Kubernetes. It includes:

• TimescaleDB for time-series historian functionality
• Node-RED for flow-based data ingestion and quick device connections
• Grafana dashboards, connectors, and other optional services

Use the Helm chart if you need a comprehensive, Kubernetes-based environment with built-in storage, visualization, and enterprise-scale orchestration.

To install:

1. Go to management.umh.app
2. Follow the Add Instance steps to add a new UMH Classic instance

For more details, refer to the chart’s README or visit our documentation.

A Unified Namespace centralizes all plant-floor data in one logical location. With UMH, you can:

• Publish real-time telemetry (e.g., from PLCs, sensors) in a standardized structure
• Subscribe any consumer (dashboards, analytics tools, custom apps) to the same data
• Easily unify or correlate data across machines and sites

To learn more about the Unified Namespace concept, see the "The Rise of the Unified Namespace" article on our Learning Portal.

• Website: umh.app
  Explore product overviews, enterprise offerings, and the UMH roadmap.
• Management Console: management.umh.app
  Connect UMH Core instances for cloud-based monitoring, configuration, and upgrades.
• Docs (Legacy & Advanced Guides): umh.docs.umh.app
  Deeper info on Helm installations, timeseries historian usage, advanced config, etc.
• Featured Articles & Tutorials: learn.umh.app/featured

Pull requests, issues, and community involvement are welcome! See our CONTRIBUTING.md and CODE_OF_CONDUCT.md for guidelines.

This project is licensed under the Apache 2.0 License. Please see CONTRIBUTOR_LICENSE_AGREEMENT_INDIVIDUAL.md and CONTRIBUTOR_LICENSE_AGREEMENT_ENTITY.md for contributor requirements.

© 2025 United Manufacturing Hub. All rights reserved.