Introduction
Looking for the old Kubernetes Helm stack? See the UMH Core vs UMH Classic FAQ to understand which edition fits your project and the current migration path.
What is UMH Core?
UMH Core is a single Docker container that turns any PC, VM, or edge gateway into an Industrial Data Hub.
In manufacturing, every device speaks a different language - PLCs use OPC UA, sensors use Modbus, MES systems use REST APIs. Connecting them all creates a tangled mess of point-to-point integrations. Change one thing, break ten others.
UMH Core creates a Unified Namespace (UNS) - a central data backbone where all your industrial data lives in one organized, validated place. Instead of 100 devices talking to each other (creating 1000s of connections), they all publish to one place, and consumers subscribe to what they need.
What's Inside
That one Docker container includes everything you need:
Redpanda – an embedded, Kafka-compatible broker that buffers every message.
Benthos-UMH – a stream-processor engine with 50+ industrial connectors.
Agent – a Go service that reads
config.yaml
, launches pipelines, watches health, and phones home to the Management Console.S6 Supervisor – keeps every subprocess alive and starts them in the correct order.
Why teams pick UMH Core
Simple
PLCs, sensors, ERP/MES, cloud services all talk to one Unified Namespace (UNS) instead of point-to-point spaghetti.
Lightweight
Runs on almost everything
No lock-in
100 % open-source stack: Redpanda, Benthos, S6, and much more
Core Concepts You'll Learn
Through our getting-started guide, you'll understand:
Instance – A running UMH Core container identified by its location path
Management Console – Cloud UI for deploying and managing instances without touching YAML
Unified Namespace (UNS) – The event-driven data backbone that eliminates point-to-point connections
Bridge – The gateway for external data into the UNS (the ONLY way data enters)
Topic – How data is addressed:
location.contract.virtual_path.tag_name
Tag – A time-series data point (like a PLC variable or sensor reading)
Virtual Path – Folder organization within topics for grouping related data
Data Model – Templates that define and validate data structure
Data Contract – Validation rules (
_raw
= no validation,_modelname_v1
= enforced structure)
Advanced concepts (after getting-started):
Stream Processor – Transforms messages already inside the UNS (e.g., device models → business models)
Stand-alone Flow – Point-to-point when UNS buffering isn't wanted
State Machines – Component lifecycle management (active/idle/degraded states)
How It Works
Your Factory Floor UMH Core Your Systems
────────────────── ──────── ────────────
PLCs (S7, Modbus) ─┐ ┌─▶ Dashboards
Sensors (OPC UA) ─┼─[Bridge]─▶ Unified Namespace ─[Bridge]─┼─▶ Cloud/MQTT
MES/ERP (REST) ─┘ (organized data) └─▶ Databases
Bridges connect your devices to the UNS (50+ protocols supported) - they're the ONLY entry point
Data flows into organized topics:
enterprise.site.area.line._contract.virtual_path.tag
Models validate critical data (optional but recommended for production)
Consumers subscribe to the data they need
Configure via Management Console UI or directly edit YAML files
Every message is buffered, validated, and organized - no data loss, guaranteed structure.
Getting Started
Sign up at management.umh.app and deploy your first instance in 60 seconds through the UI.
Prefer step-by-step learning? Follow our progressive 4-step guide:
Install UMH Core - One Docker command (5 minutes)
Connect Your First Data - Create a Bridge and see data flow (10 minutes)
Organize Your Data - Scale from 1 to 1000s of tags automatically (15 minutes)
Validate Your Data - Add quality control with Data Models (20 minutes)
By the end, you'll have production-ready data pipelines with validation, organization, and monitoring.
Documentation Structure
Usage Guides - Step-by-step implementation guides
Instances - Managing and configuring UMH Core deployments
Unified Namespace - Core messaging architecture
Data Flows - Connect and process data streams
Data Modeling - Enterprise data structuring
Management Console - Cloud-based control center
Production Deployment - Scaling, security, and operations
Reference Documentation - Complete API and configuration reference
Learn More About UNS
For deeper understanding of the concepts behind UMH Core:
The Unified Namespace Course Series - 4-chapter comprehensive course
Chapter 1: OT Foundations - Automation pyramid challenges
Chapter 2: The Rise of UNS - Core architecture principles
Chapter 3: IT Foundations - Modern IT patterns
Industrial IoT Architecture - Edge computing in manufacturing
MQTT vs UNS Comparison - Why data contracts matter
Community & Support
Discord Community - Get help and connect with other users
GitHub Repository - Source code and issue tracking
Management Console - Web-based configuration and monitoring
UMH Website - Company and product information
Last updated