bridgelink-launcher

An open source Admin Launcher for BridgeLink (and OSS Mirth Connect)

MacOS Specific Instructions

Because the application is not signed by Apple, you may get a security warning and have to manually override your security settings to grant an exception to the launcher.

Known Issue: If you extract the BridgeLink Launcher application straight to your Downloads folder, it will give you an error about "Read-Only Filesystem" when you try to save an entry.

To prevent this, you can do one of the following:

• Move the application to a different folder, such as /Applications or ~/Applications
• Create a new folder inside downloads then move the application there
• Enable All Applications in MacOS Gatekeeper by following these steps:
  • Open up System Settings
  • In System Settings, navigate to "Privacy & Security". Leave Window Open in the Background
  • Open up Terminal (as separate window). DO NOT CLOSE System Settings
  • In Terminal, run "sudo spctl --master-disable" --> Type Password --> Click Enter
  • In System Settings, navigate out of "Privacy & Security" Page (For Example -- Click on "Lockscreen"), then navigate back to "Privacy & Security"
  • In System Settings --> Privacy & Security Page --> Scroll Down to bottom --> Select "Allow Application From" --> Select "Anywhere" (the option will now appear) --> Type Password Completed

Upgrading via macOS DMG

When installing a new version of BridgeLink Launcher using the macOS .dmg, your connection data is stored inside the application bundle and will be overwritten if you simply drag the new version into /Applications.

To preserve your connections and settings, follow these steps before upgrading:

1. Before upgrading, open Finder and navigate to your current application:

   • Right-click BridgeLink Administrator Launcher.app → Show Package Contents
   • Navigate to Contents/Resources/app/data/
   • Copy the entire data folder to a safe temporary location (e.g., your Desktop)

2. Install the new version by mounting the new .dmg and dragging the application to /Applications, replacing the old one.

3. After upgrading, restore your data:

   • Right-click the newly installed app → Show Package Contents
   • Navigate to Contents/Resources/app/
   • Copy your saved data folder back into this location, replacing the new empty one

Your connections and settings will now be restored in the upgraded application.

License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0).

You are free to use, modify, and distribute this software under the terms of the MPL-2.0 license. This license requires that if you distribute modified versions of this software, you must also make the source code of those modifications available under the MPL-2.0.

For full details, see the LICENSE file or visit the MPL-2.0 documentation.