Skip to content
The swiss army knife of healthcare integration.
Branch: development
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
client Fixing issue with dragging step onto itself clearing properties out. Dec 19, 2018
command Appending license, organizing imports, formatting. Dec 19, 2018
generator MIRTH-2278: Changed ORC-4 description from "Placer Order #" to "Place… May 15, 2013
manager Appending license, organizing imports, formatting. Dec 19, 2018
server The launch page will now redirect to S3 if the installer file isn't Dec 19, 2018
simplesender Formatted code. Apr 3, 2012
.gitignore Adding .gitignore Jul 24, 2017

NextGen Connect Integration Engine (formerly Mirth Connect)

  1. General Information
  2. Installation and Upgrade
  3. Starting Mirth Connect
  4. Running Mirth Connect in Java 9 or greater
  5. License
  6. More Information

1. General Information

The Mirth Solutions Mission

Mirth Solutions help many of the nation's largest, most respected healthcare entities streamline their care-management processes to satisfy the demands of a regulatory, competitive healthcare industry. With Mirth Solutions, NextGen Healthcare's goal is to provide the healthcare community with a secure, efficient, cost-effective means of sharing health information. The natural product of this aim is a family of applications — which includes Mirth Connect — flexible enough to manage patient information, from small practices to large HIEs, so our clients and users can work confidently and effectively within the healthcare-delivery system.

About Mirth Connect

Like an interpreter who translates foreign languages into the one you understand, Mirth Connect translates message standards into the one your system understands. Whenever a "foreign" system sends you a message, Mirth Connect's integration capabilities expedite the following:

  • Filtering — Mirth Connect reads message parameters and passes the message to or stops it on its way to the transformation stage.
  • Transformation — Mirth Connect converts the incoming message standard to another standard (e.g., HL7 to XML).
  • Extraction — Mirth Connect can "pull" data from and "push" data to a database.
  • Routing — Mirth Connect makes sure messages arrive at their assigned destinations.

Users manage and develop channels (message pathways) using the interface known as the Administrator: Administrator screenshot

2. Installation and Upgrade

Mirth Connect installers are available for individual operating systems (.exe for Windows, .rpm and .sh for Linux, and .dmg for Mac OS X). Pre-packaged distributions are also available for individual operating systems (ZIP for Windows, tar.gz for Linux, and tar.gz for Mac OS X). The installer allows you to automatically upgrade previous Mirth Connect installations (starting with version 1.5).

Mirth Connect installers also come with the option to install and start a service which will run the background. You also have the option of installing and running the Mirth Connect Server Manager, which allows you to start and stop the service on some operating systems, change Mirth Connect properties and backend database settings, and view the server logs.

An optional Mirth Connect Command Line Interface can be installed, allowing you to connect to a running Mirth Connect Server using a command line. This tool is useful for performing or scripting server tasks without opening the Mirth Connect Administrator.

After the installation, the Mirth Connect directory layout will look as follows:

  • /appdata/mirthdb: The embedded database (Do NOT delete if you specify Derby as your database). This will be created when the Mirth Connect Server is started. The path for appdata is defined by the dir.appdata property in
  • /cli-lib: Libraries for the Mirth Connect Command Line Interface (if installed)
  • /client-lib: Libraries for the Mirth Connect Administrator
  • /conf: Configuration files
  • /custom-lib: Place your custom user libraries here. These libraries will be loaded on the Mirth Connect Server classpath when it is started, making them accessible to channel scripts.
  • /docs: This document and a copy of the Mirth Connect license
  • /docs/javadocs: Generated javadocs for the installed version of Mirth Connect. These documents are also available when the server is running at http://[server address]:8080/javadocs/ (i.e. http://localhost:8080/javadocs/).
  • /extensions: Libraries and meta data for Plug-ins and Connectors
  • /logs: Default location for logs generated by Mirth Connect and its sub-components
  • /manager-lib: Libraries for the Mirth Connect Server Manager (if installed)
  • /public_html: Directory exposed by the embedded web server
  • /server-lib: Mirth Connect server libraries
  • /webapps: Directory exposed by the embedded web server to host webapps

3. Starting Mirth Connect

Once Mirth Connect has been installed, there are several ways to connect to launch the Mirth Connect Administrator. On a Windows installation, there is a Mirth Connect Administrator item in the Start Menu which launches the application directly.

If the option is not available, you can connect to the Mirth Connect Administrator launch page which by default should be available at http://[server address]:8080 (i.e. http://localhost:8080). Clicking the Launch Mirth Connect Administrator button will connect you to the server which will be listening on https://[server address]:8443 (i.e. https://localhost:8443). If running a new installation, the default username and password for the login screen is admin and admin. This should be changed immediately for security purposes.

If you are launching the administrator for the first time, you will notice that the libraries for the Mirth Connect Administrator will be loaded. This feature allows you run the Administrator from any remote Mirth Connect server without having to download and install a separate client.

You may also notice a security warning when starting the administrator (dialog box depends on browser being used). This is because by default Mirth Connect creates a self-signed certificate for its web server. For now click Run to continue launching the administrator, but check out the User Guide for instructions on how to replace the certificate.

4. Running Mirth Connect in Java 9 or greater

In order to run Mirth Connect in Java 9 or greater, copy the options from docs/mcservice-java9+.vmoptions and append them to either mcserver.vmoptions or mcservice.vmoptions, depending on your deployment. Then restart Mirth Connect.

To run the Mirth Connect Command Line Interface, create a new file named mccommand.vmoptions in the Mirth Connect root directory. Copy all of the options from docs/mcservice-java9+.vmoptions into mccommand.vmoptions and save before launching the Command Line Interface.

5. License

Mirth Connect is released under the Mozilla Public License version 1.1. You can find a copy of the license in server/docs/LICENSE.txt.

All licensing information regarding third-party libraries is located in the server/docs/thirdparty folder.

6. More Information

Download Mirth Connect and the official User Guide at:

View the release notes, upgrade guide, FAQs, and examples at:

Join the Mirth Community Forums at:

Our public Slack group is located at: You can join up here:

You can’t perform that action at this time.