Config File
The configuration file editor allows you to directly modify your instance's /data/config.yaml
file through the Management Console UI.
Accessing the Config Editor
Two ways to open the configuration editor:
From Instance Details: Click the "Config File" button in the top-right corner
From Instance Overview: Click the context menu (⋮) → "Config File"

⚠️ Warning: Direct YAML Editing
You are editing the config.yaml file directly. Use this feature with caution:
Invalid YAML syntax will break your instance
Recovery requires SSH access to the container
The agent applies changes via hot-reload - no restart needed
Editor Controls
Main Actions
Refresh: Reload the current configuration from the instance
Save: Apply your changes (the agent will hot-reload)
Additional Options (⋮ menu)

Download: Save a local copy of the configuration
Local File Sync:
Open Local File: Edit the config in your preferred IDE
Create Local File: Start a new local file for editing
Local file sync enables:
Version control with Git
IDE features (syntax highlighting, validation, autocomplete)
AI assistant integration (Cursor, GitHub Copilot, Claude)
Configuration Structure
The editor shows your complete configuration with main sections:
templates:
protocolConverter:
# Reusable bridge templates
protocolConverter:
- name: my-bridge
# Bridge configurations (shown as "Bridges" in UI)
dataFlow:
- name: my-flow
# Stand-alone flow configurations
Key sections:
templates:
- Reusable configuration blocks for templatingprotocolConverter:
- Bridge definitions (UI shows as "Bridges")dataFlow:
- Stand-alone flow definitionsdataContracts:
- Data validation rulesdataModels:
- Data structure definitions
For complete documentation, see Configuration Reference.
UI ↔ YAML Synchronization
UMH Core maintains two-way sync between UI and YAML:
UI → YAML: When you create bridges or data models in the UI, they appear here automatically
YAML → UI: After saving YAML changes, they're reflected in the UI immediately
This enables flexible workflows:
OT teams: Use the UI for visual configuration
IT teams: Use YAML for infrastructure-as-code
Learning: Create in UI, study the generated YAML
Scaling: Template in YAML for multiple similar devices
Troubleshooting
Syntax Errors: The Save button will show errors if YAML is invalid. Common issues:
Incorrect indentation (use spaces, not tabs)
Missing colons after keys
Unclosed quotes
Changes Not Applied: Ensure you clicked Save. Check the agent logs if changes don't take effect.
Recovery from Bad Config: If the instance breaks:
SSH into the container
Edit
/data/config.yaml
directlyThe agent will auto-reload when valid
Next Steps
Configuration Reference - Full YAML schema
Variables - Template variables and substitution
Bridges - Configure data connections
Last updated