Issue with uploading LOINC Terminology on HAPI-FHIR by CLI

45 views
Skip to first unread message

deadwall

unread,
Aug 25, 2025, 7:32:59 AMAug 25
to HAPI FHIR
Hi. We're in the process of creating an internal HAPI-FHIR Terminology server and were adding LOINC terminology zips.
When we use the instructions in https://hapifhir.io/hapi-fhir/docs/tools/hapi_fhir_cli.html#upload-terminology it fails, primarily due to the command:

./hapi-fhir-cli upload-terminology -d Downloads/LOINC_2.54_MULTI-AXIAL_HIERARCHY.zip -d Downloads/LOINC_2.54_Text.zip -v r4 -t http://localhost:8080/fhir -u http://loinc.org

which expects two inputs.

The current downloadable LOINC zip format has changed, and provides only one overall zip - https://loinc.org/downloads/
How can we upload terminology details using the cli with the new LOINC zip format?

Preston Lee

unread,
Dec 5, 2025, 11:22:49 AMDec 5
to HAPI FHIR
Trying again today with hapi-fhir-cli upload-terminology -v r4 -t http://localhost:8081/fhir -s 8GB -u http://snomed.info/sct -d Loinc_2.81.zip, I get the same error. What was the resolution to this?

Preston Lee

unread,
Dec 5, 2025, 11:54:33 AMDec 5
to HAPI FHIR
Nevermind.. looks like the default loincupload.properties is just super outdated. For LOINC 2.81, at least, it works with the line:

    loinc.hierarchy.file=AccessoryFiles/ComponentHierarchyBySystem/ComponentHierarchyBySystem.csv

..and then running hapi-fhir-cli with:

    hapi-fhir-cli upload-terminology -v r4 -t http://localhost:8081/fhir -s 2GB -u http://loinc.org -d Loinc_2.81.zip -d loincupload.properties
Reply all
Reply to author
Forward
0 new messages