United Manufacturing Hub
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
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 (industrial PC, cloud VM, ARM64 gateway – no Kubernetes required).
Quick Start
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:
- Go to management.umh.app
- 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.
Helm Chart (UMH Classic)
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:
- Go to management.umh.app
- 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.
Unified Namespace Overview
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.
Further Resources
- 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
Security Scanning
We use Snyk for security vulnerability scanning to ensure the safety and compliance of our codebase.
Running Snyk Locally
-
Install Snyk CLI:
brew install snyk-cli # macOS
# For other platforms, see: https://docs.snyk.io/snyk-cli/install-or-update-the-snyk-cli
-
Authenticate:
snyk auth
-
Run security scan:
# From the root directory
snyk test umh-core/
# Or from within umh-core directory
cd umh-core && snyk test
Contributing
Pull requests, issues, and community involvement are welcome! See our CONTRIBUTING.md and CODE_OF_CONDUCT.md for guidelines.
License
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.
