Skip to content

Connection Guide

Synura Connect handles the secure connection between Mirth and Synura. It uses MLLP over TLS on port 443. Most Mirth installations don’t include TLS support out of the box — Synura Connect bridges that gap.


Before you begin, confirm you have:

  • Your Synura subdomain (e.g. acmelab), provided during onboarding
  • Mirth Connect 3.8.1 or later installed and running
  • Outbound network access from the Mirth server to synura.io on port 443
  • A Synura dashboard account to verify message delivery

Your connection endpoint is:

Host: {subdomain}.synura.io
Port: 443
Protocol: MLLP over TLS

Replace {subdomain} with the value assigned to your organisation.


Before configuring TLS, confirm you can reach Synura from the Mirth server.

Windows (PowerShell):

Terminal window
Test-NetConnection {subdomain}.synura.io -Port 443

Linux / macOS:

Terminal window
openssl s_client -connect {subdomain}.synura.io:443 -servername {subdomain}.synura.io

A successful test shows a completed TLS handshake with CN=*.synura.io in the certificate chain. If the test fails, check that outbound TCP 443 is permitted by your firewall.


PathWho it’s forWhat you need
Path A: Synura InstallerMost customersDownload the installer — handles everything
Path B: Manual stunnelTeams that prefer manual configurationInstall and configure stunnel yourself
Path C: NextGen SSL ManagerCustomers with a commercial Mirth licenceYour existing SSL Manager plugin
Path D: Zen SSL ExtensionCustomers with the Zen SSL pluginYour existing Zen SSL plugin
Path E: Enterprise TLS proxyOrganisations with existing TLS infrastructureYour IT team configures the proxy

The fastest path. The installer configures stunnel, deploys the Mirth polling channel and verifies the connection in one run.

Download the bundle for your platform: SynuraMirthConnector-windows.zip (3.7 MB) for Windows or SynuraMirthConnector-linux.tar.gz (10 KB) for Linux. Extract the archive, then follow the Quick Start guide for the full walkthrough.


If you prefer to configure each component yourself, follow the Manual Setup guide. It walks through stunnel installation, configuration, certificate import, and channel creation step by step.


If your commercial Mirth licence includes SSL Manager, you can configure TLS directly on a TCP Sender connector without stunnel. However, note that Synura uses a polling model (Mirth pulls messages from Synura), not a push model. You will still need to create a JavaScript Reader source channel.

SSL Manager is a paid NextGen extension (Silver/Gold/Platinum subscriptions). It is not part of the open-source Mirth download. Synura does not provide or support this plugin.

If you have SSL Manager and want to use it, contact support@synura.io for guidance on configuring the JavaScript Reader to use SSL Manager’s TLS context instead of stunnel.


If you have the Zen SSL Extension from ConsultZen, the same applies as Path C — you can use it for the TLS layer, but the Mirth channel must still use the JavaScript Reader polling pattern.

Zen SSL is a third-party commercial plugin (annual subscription). Synura does not provide or support it. Details at consultzen.com.

Contact support@synura.io for guidance on integrating Zen SSL with the polling channel.


If your organisation runs a TLS termination proxy (F5, HAProxy, nginx, etc.), your infrastructure team can forward MLLP traffic to Synura directly.

Hand your IT team these configuration values:

SettingValue
Listen address127.0.0.1 (or an internal IP accessible to the Mirth server)
Listen port6661 (or any available port)
Upstream host{subdomain}.synura.io
Upstream port443
ProtocolTLS 1.2 or higher
SNIRequired — must send {subdomain}.synura.io as the SNI hostname
Client certificateNot required (server-side TLS only)

Once the proxy is running, follow the Manual Setup guide from Step 6 onwards to create the Mirth polling channel. Set stunnelPort in the channel script to whatever port your proxy listens on.


If you need help choosing a path or run into issues, contact support@synura.io with your subdomain and Mirth version.