Minimal Launcher

The Minimal Launcher launches the familiar Open Integration Engine (OIE) admin console directly from the NovaMap portal. Launching an admin console has historically meant moving passwords around, keeping them in text files, and splitting them across workstations. The Minimal Launcher handles authentication within the platform's OIDC context and eliminates the need for clunky configuration and credential management.

It preserves your authenticated portal identity through use of the NovaMap OIDC plugin, so there is no separate set of credentials to configure or store.

Download the installer for your operating system. Each download is a ZIP archive containing the installer.

• Windows installer
• macOS installer
• Linux installer

1. Download and install the launcher for your operating system.
2. If macOS Gatekeeper, Windows Defender, or another security prompt appears, allow the app to open or install.
3. In the portal, open an instance and click Launch Admin Console.
4. When your browser asks to open the NovaMap Admin Launcher, choose Allow or Open.
5. If the launcher asks you to trust a server certificate, review it and accept. You can choose Don't Ask Again so you are not prompted every time.
6. The admin console starts on your desktop. When it closes, the portal updates to show it is no longer active.

• Launch the admin console from the portal in one click after a one-time install.
• No separate Java Web Start setup on your machine.
• Remembers trusted server certificates so repeat launches are smoother.
• The portal can show when a console is active on your instance.

• macOS, Windows, or a Debian/Ubuntu-based Linux.
• Permission from your browser and operating system to open the launcher when prompted.
• Willingness to trust the instance certificate the first time you connect, if asked.

An OIE user is created automatically, linked to your identity on the portal, so any actions taken inside OIE are audited against that identity.

A separate novamap_portal system user is created for monitoring purposes. It is distinct from the user account linked to your portal identity.

The portal can show when a console is active on your instance. When the console closes, the portal updates to show it is no longer active.

The Minimal Launcher is available to anyone with a NovaMap portal account, including on the free OIE dev instance.

Send an email to support@novamap.health.