Installation

Install, authenticate, and troubleshoot the HeartLab Agent.

HeartLab Agent

The HeartLab Agent is a Windows and macOS application that enables HeartLab to communicate securely with clinical data on your local network. Once installed, the Agent can be used to automatically upload cardiac stress tests, standalone PDF content, and to deliver completed reports.

The HeartLab Agent requires Windows 10 or later (x64), or macOS 10.15 or later on an Intel or Apple silicon Mac.

Installing the HeartLab Agent

Install the HeartLab Agent on a computer that is powered on, remains logged in, and has a reliable network connection. Prevent the computer from sleeping while the Agent is needed.

To install the HeartLab Agent:

Navigate to Settings → Integrations → Agent.

Select Download, then choose Windows or macOS for the computer where the Agent will run.

Windows

Run the downloaded .exe installer and follow the installation prompts.
Open HeartLab Agent.

The Agent starts automatically when you log in and is available from the Windows system tray.

macOS

Open the downloaded .dmg disk image.
Drag HeartLab Agent into the Applications folder.
Open HeartLab Agent from Applications, then eject the disk image.

The Agent starts automatically when you log in and is available from the macOS menu bar. It does not appear in the Dock.

Run the Agent from Applications so it can start at login and install updates. If you see Move HeartLab Agent to Applications, quit the Agent, move it into Applications, and open it from there.

Authenticate the HeartLab Agent

After installation:

Navigate to Settings → Integrations → Agent.
Select Create Agent.
Enter an Agent name (typically the name of the computer where it is installed).
Select Create Agent.
Locate the following information:
- Agent URL
- Agent Token

The Agent Token is displayed only once and cannot be viewed again after creation.

Open the HeartLab Agent.
Open the Authentication tab.

Enter the Agent URL and Agent Token values.
Select Test Connection.
Confirm the message says Connection test succeeded

Once authenticated, the HeartLab Agent is ready to be used with supported HeartLab features.

Troubleshooting

If the Agent does not connect to HeartLab:

Verify the Agent URL is correct.
Verify the Agent Token has been entered correctly.
Confirm the computer has internet access.
Confirm no firewall or security software is blocking the HeartLab Agent.
Re-run Test Connection.

If authentication still fails, create a new Agent and repeat the authentication process.

If problems persist, contact HeartLab Support.

VPN: Site-to-site

Prepare and configure site-to-site VPN tunnels for secure network connectivity to HeartLab.

PDF Upload

Automatically upload PDF reports into HeartLab using the HeartLab Agent.

Manufacturer: HeartLab Limited 305 / 150 Karangahape Road Auckland 1010 New Zealand
UK Responsible Person: Casus UKRP Ltd 107-111 Fleet Street London EC4A 2AB United Kingdom
Australian Sponsor: Emergo Australia Level 20 Tower II Darling Park 201 Sussex Street Sydney NSW 2000 Australia

Applies to HeartLab v7.16.0 and above Effective 2026-10-19 eIFU version 1.11 UDI-DI 09421907090023