Getting Started

Getting Started

Installation

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

   • macOS: .dmg file (universal binary — Apple Silicon and Intel)
   • Windows x86_64: .msi or .exe installer
   • Windows ARM64: .msi or .exe installer
   • Linux x86_64: .deb, .rpm, or .AppImage
   • Linux ARM64: .deb, .rpm, 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 Add 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) or another Launcher instance:

1. Click the Import button in the top toolbar
2. Select the JSON connections file (e.g., <MCAL-root>/data/connections.json)
3. If any connections already exist with the same IDs, Launcher will warn you and list the duplicates — you can choose to overwrite or cancel
4. After a successful import, the page reloads to show the new connections