Butterfly

This guide covers end-to-end Butterfly setup for sending DICOM studies to HeartLab.

Applies to

• Users with Integrations: DICOM permission (typically Administrators)
• Butterfly organization administrators

Create DICOM Identity in HeartLab:

1. In HeartLab, navigate to Settings > Devices > DICOM.

2. Click View DICOM Endpoints and note the following under 'DICOM via TLS':

• Server AE title
• Server IP address
• TLS port (typically 11112)

3. Download Server CA Certificate in PEM Format
4. Click Create DICOM Identity
5. Enter a name, and device AE title.

The server AE title, device AE title, server IP address and server CA certificate will be used in a later step.

Create Butterfly TLS connection

1. In Butterfly, navigate to Organizational Settings > Connectivity
2. Click + Add, next to Connections

3. The following fields should be configured accordingly:
   • Name: Enter connection nickname of your choice.
   • TLS: Set to Active
   • SCP Certificate: Upload the Server CA Certificate (PEM format).
   • SCP Security: Set to Anonymous
   • Host: Enter server IP address, noted in previous step.
4. Click Save.

Add Butterfly PACS integration

1. In Butterfly, navigate to Organizational Settings > Connectivity
2. Click + Add, next to Integrations

3. The following fields should be configured accordingly:
   • Name: Connection nickname of your choice.
   • Type: Must match the connection in the previous step.
   • Calling AET: Enter device AE title, noted in previous step.
   • AET: Enter server AE title, noted in previous step.
   • Port: 1112

Enable automatic sending

1. Open the target archive/folder in Butterfly.
2. Select the PACS integration created above.
3. Set export behavior (for example, on exam end).

Troubleshooting

• AE title mismatch is the most common cause of failed sends.
• Confirm TLS certificate upload and verify the selected connection type.
• If needed, send a single test study before enabling auto-send globally.

Related

• DICOM Identity
• Lumify