Runbeam logo
Secure Data Packaging

JMIX Connector

Package DICOM studies into secure, portable envelopes for cross-organisation sharing, cloud migration, and data export.

The Challenge

Sharing medical imaging is complex

Security Requirements

Medical data must be encrypted and integrity-verified when crossing organisational boundaries.

Protocol Barriers

DICOM networks are typically isolated. Sharing requires VPNs, gateways, or manual exports.

Tracking & Audit

Compliance requires knowing exactly what data was shared, when, and with whom.

The Solution

Package and share via HTTP

Harmony's JMIX connector queries your DICOM sources and packages studies into portable, manifest-documented envelopes that can be downloaded over standard HTTP.

Query by Study UID

Request envelopes by Study Instance UID - Harmony handles the DICOM retrieval.

Complete manifests

Every envelope includes a JSON manifest documenting contents for audit.

Standard HTTP download

Download as ZIP or GZIP - no special clients or protocols required.

# JMIX packaging pipeline
[pipelines.jmix]
description = "Package DICOM studies as JMIX envelopes"
networks = ["http_net"]
endpoints = ["jmix_endpoint"]
middleware = ["jmix_builder"]
backends = ["dicom_pacs"]
# JMIX endpoint
[endpoints.jmix_endpoint]
service = "jmix"
[endpoints.jmix_endpoint.options]
path_prefix = "/jmix"
# DICOM backend
[backends.dicom_pacs]
service = "dicom_scu"
target_ref = "orthanc"
API

Simple HTTP API

Create, retrieve, and download JMIX envelopes via standard REST endpoints.

GET/jmix/api/jmix?studyInstanceUid={uid}

Create Envelope

Request a JMIX envelope for a DICOM study by Study Instance UID.

GET/jmix/api/jmix/{envelope_id}

Download Envelope

Download a stored envelope as ZIP or GZIP based on Accept header.

GET/jmix/api/jmix/{envelope_id}/manifest

Get Manifest

Retrieve the manifest.json for a stored envelope.

Capabilities

What Harmony provides

DICOM to JMIX Packaging

Query DICOM sources via C-FIND/C-MOVE and package retrieved studies into JMIX envelopes automatically.

Envelope Storage

Store packaged envelopes locally or in cloud storage for later retrieval and distribution.

Manifest Generation

Generate JSON manifests listing all files, metadata, and optional integrity hashes.

Performance Optimisation

Skip hashing or file listing for high-throughput scenarios where speed is critical.

Schema Validation

Validate envelopes against JMIX schema specifications for compliance.

Use Cases

When to use JMIX

Cross-Organisation Sharing

Package patient imaging studies for secure transfer between healthcare organisations without exposing DICOM infrastructure.

Cloud Migration

Export studies from on-premise PACS into portable JMIX envelopes for cloud storage or archival.

Research Data Export

Package de-identified imaging data for research collaborations with complete manifests.

Disaster Recovery

Create portable backups of critical imaging studies in a standardised, verifiable format.

Get Started

Package and share imaging data

Deploy secure JMIX packaging with DICOM integration in minutes.