Quick Start

Get JamBridge running and processing your first HL7v2 ADT^A01 message in under 10 minutes.

Prerequisites

• Docker + Docker Compose v2
• Ports open: 8443, 2575–2582, 8080

1. Clone and configure

git clone https://github.com/AKHester-Technologies/jambridge
cd jambridge
cp BridgeConfig.example.yaml BridgeConfig.yaml

Edit BridgeConfig.yaml — three required values for a minimal deployment:

BridgeConfig.yaml

bridge:
  facility-code: BRANCH-01
  hapi-fhir-url: http://hapi:8080/fhir
  consent:
    enabled: true
    fail-closed: true

2. Start everything

docker compose up

First startup takes 60–90 seconds for HAPI FHIR to initialise.

3. Verify

./scripts/verify.sh

Expected output:

✓ JamBridge health endpoint (200)
✓ MLLP listener :2575 (ADT)
✓ MLLP listener :2576 (ORU)
✓ HAPI FHIR metadata (200)
✓ JamMPI Patient/$match endpoint
✓ AJ Consent Manager health
All checks passed ✓

4. Send a test message

./scripts/send-test-adt.sh

Expected response:

MSA|AA|TEST-001|Patient admitted and stored in FHIR
Transaction: TEST-26060612-001 | Golden: GOLDEN-00441 | Duration: 4821ms

5. Query the FHIR result

curl http://localhost:8080/fhir/Patient?identifier=TEST-MRN-001 \
  -H "Accept: application/fhir+json" | jq .

What's running

Service	Port	Description
JamBridge	8443 / 2575–2582	Integration engine + MLLP
HAPI FHIR	8080	FHIR R4 data store
JamMPI	8081	Master patient index
AJ Consent	8082	Consent enforcement
PostgreSQL	5432	Shared database

Next: Prerequisites →