Getting Started

Getting Started

Installation

1. Go to Releases and download the installer for your platform:

   • macOS: .dmg file (Apple Silicon / Intel)
   • Windows: .msi installer
   • Linux: .deb or .AppImage

2. Install normally for your OS.

macOS Note

If macOS blocks the app because it is unsigned, either:

• Right-click the app and choose Open, then click Open in the dialog
• Or run: xattr -cr /Applications/Launcher.app

Prerequisites

• Java Runtime (JRE 8+) must be installed on your machine. Launcher uses it to run the administrator client.
• Launcher will attempt to auto-detect your JAVA_HOME. If it cannot, you can set it manually per connection.

First Launch

1. Open Launcher.
2. Click the + button in the top right to create a new connection.
3. Fill in:
   • Name: A label for this server (e.g., "Production")
   • Address: The server URL (e.g., https://myserver:8443)
   • Username / Password: Your admin credentials (optional, can be entered at login)
4. Click Create.
5. Double-click the server row (or click the play button) to launch the administrator.

Importing Existing Connections

If you are migrating from MirthConnect Admin Launcher (MCAL):

1. Locate your MCAL connections file at <MCAL-root>/data/connections.json
2. Use the import feature to bring them into Launcher
3. Launcher will auto-detect your Java Home on import