MergenHub listens on two TCP ports by default and the installer opens them in Windows Firewall. This page lists every port, the rules the installer creates, and how to open, restrict or remove them by hand.
Ports MergenHub uses
| Port | Direction | Purpose | Change in |
|---|---|---|---|
| 8090 TCP | inbound | Web UI, REST API, Data Bridge REST server, MCP endpoint | Installer › Server address and ports; Settings › Web & REST API |
| 443 TCP | inbound | HTTPS for the same services (only when HTTPS is enabled) | Installer › HTTPS; Settings › Web & REST API |
| 48010 TCP | inbound | OPC UA server (opc.tcp://host:48010/MergenHub) | Settings › OPC UA Server › Endpoints |
| device ports | outbound | Modbus 502, S7 102, OMRON 9600 (FINS) / 44818 (CIP), DNP3 20000, IEC 104 2404, IEC 61850 102, MQTT 1883/8883, OPC UA client to remote servers | per channel/device |
| 25 / 465 / 587 | outbound | SMTP for e-mail notifications | Settings › E-mail |
| 443 | outbound | SMS provider API, license portal (activation, refresh, update check) | — |
Outbound connections are normally allowed by Windows Firewall; only the inbound ports need rules.
Rules the installer creates
The installer runs netsh advfirewall and adds these inbound allow rules (all profiles, TCP):
| Rule name | Port |
|---|---|
MergenHub Web | the web port you chose (8090) |
MergenHub OPC UA | the OPC UA port (48010) |
MergenHub HTTPS | the HTTPS port (only when HTTPS was enabled) |
They are removed again by the uninstaller. You can see them in Windows Defender Firewall with Advanced Security › Inbound Rules.
Opening or changing ports manually
Run in an administrator command prompt:
netsh advfirewall firewall add rule name="MergenHub Web" dir=in action=allow protocol=TCP localport=8090
netsh advfirewall firewall add rule name="MergenHub OPC UA" dir=in action=allow protocol=TCP localport=48010
netsh advfirewall firewall add rule name="MergenHub HTTPS" dir=in action=allow protocol=TCP localport=443
PowerShell equivalent:
New-NetFirewallRule -DisplayName "MergenHub Web" -Direction Inbound -Protocol TCP -LocalPort 8090 -Action Allow
If you changed a port in Settings, add a rule for the new port and delete the old one:
netsh advfirewall firewall delete rule name="MergenHub Web"
Restricting who may connect
Limit a rule to specific networks instead of the whole world:
netsh advfirewall firewall set rule name="MergenHub OPC UA" new remoteip=10.0.0.0/24,192.168.10.0/24
netsh advfirewall firewall set rule name="MergenHub Web" new profile=domain,private
For internet-facing servers prefer a reverse proxy on 443 and keep 8090 bound to 127.0.0.1 (set the host to 127.0.0.1 in Settings › Web & REST API). See Publishing on a domain.
Third-party firewalls and antivirus
- Endpoint security suites (Kaspersky, ESET, Sophos …) have their own firewall; add the same TCP ports there.
- Some products flag the unsigned installer. Right-click the file › Properties › Unblock, or add an exclusion for
C:\Program Files\MergenHub. - On corporate PCs with AppLocker / WDAC the installer may be blocked entirely; ask the administrator to allow the publisher or the path.
Verifying
- From another machine:
Test-NetConnection <host> -Port 8090(PowerShell) — TcpTestSucceeded : True means the port is open. - On the server:
netstat -ano | findstr :8090shows the listening socket and the process ID of theMergenHubservice. - The Event log (… › Event Log) shows
Web API listening on …andOPC UA server startedlines when the services are up.
Troubleshooting
| Symptom | Likely cause |
|---|---|
| Web UI works on the server but not from other PCs | Host set to localhost — change it to 0.0.0.0 in Settings › Web & REST API and restart the service; or the firewall rule is missing |
| OPC UA client sees the endpoint but cannot connect | Endpoint host name differs from what the client uses; certificate not trusted; security policy mismatch |
| Browser says "connection reset" on HTTPS | HTTPS enabled but no valid web.pfx in webpki\; check the event log |
| Port already in use | Another program (often another OPC server) uses 48010 or 8090; change the port in Settings |
MergenHub