Contents
Quickstart
Obtaining binaries
Opening Orthanc Explorer
Uploading DICOM files
Uploading through the DICOM protocol
Next steps
Obtaining binaries¶
To obtain the Orthanc binaries, you have several possibilities:
Use
jodogne/orthanc
Docker images.Use
orthancteam/orthanc
Docker images.On GNU/Linux, use precompiled packages for Debian/Ubuntu (courtesy of DebianMed and Sébastien Jodogne), orfor openSUSE(courtesy of Axel Braun).
On GNU/Linux, use our LSB binaries (Linux Standard Base), thatshould easily and immediately run on most distributions. Thosebinaries are statically linked together with all their third-partydependencies. Don’t forget to execute
chmod +x ./Orthanc
inorder to be able to run the main Orthanc executable.External contributors are also maintaining Vagrant VM for Orthanc.
Furthermore, if you are running Debian 9 (stretch), Debian 10(buster), Debian 11 (bullseye), Debian 12 (bookworm), Ubuntu 18.04 LTS(bionic), Ubuntu 20.04 LTS (focal), or Ubuntu 22.04 LTS (jammy) on anAMD64 architecture, Sébastien Jodogne maintains a standaloneDebian repository that provides the latest versions of the LSBbinaries. For instance, here is how to install the Stone Webviewer on a barebone Docker setup:
# docker run --rm -t -i -p 8042:8042 -p 4242:4242 debian:9$ apt update$ DEBIAN_FRONTEND=noninteractive apt install -y software-properties-common wget curl nano gnupg apt-transport-https$ apt install --upgrade ca-certificates$ wget -qO - https://debian.orthanc-labs.com/archive.key | apt-key add -$ apt-add-repository "deb https://debian.orthanc-labs.com/ `grep VERSION_CODENAME /etc/os-release | cut -d'=' -f 2` main"$ apt clean && apt update$ apt install orthanc-stone-webviewer$ /etc/init.d/orthanc start
Note that this standalone Debian repository does not contain thePython plugin and the Java plugin, because these plugins must be dynamically linkedagainst the system-wide version of your Python or Java runtimeenvironment. You should install the orthanc-python
ororthanc-java
package from your native Debian/Ubuntu distributionif available, or compile the plugin from sources.
Opening Orthanc Explorer¶
The most straightforward way to use Orthanc consists in openingOrthanc Explorer, the embedded administrative interface ofOrthanc, with a Web browser. Once Orthanc is running, open thefollowing URL: http://localhost:8042/app/explorer.html. Please notethat:
The port number 8042 depends on your configuration.
Orthanc Explorer does not work with Microsoft InternetExplorer. Please use Mozilla Firefox, Google Chrome, Apple Safari,or any WebKit-based Web browser.
Uploading DICOM files¶
The Orthanc Explorer interface contains a user-friendly page to uploadDICOM files. You can reach the upload page athttp://localhost:8042/app/explorer.html#upload. Then, you can drag anddrop your DICOM files and click on the Upload button.
You can watch this video tutorial that shows howto upload files to Orthanc through Orthanc Explorer with Chromium.
Important: There is currently a known issue that mightprevent Mozilla Firefox to correctly upload all DICOM files if usingdrag-and-drop.
Uploading through the DICOM protocol¶
Once Orthanc is up and running, any imaging modality can sendinstances to Orthanc through the DICOM protocol (with the C-Storecommand). Check this tutorial toconnect your modality to Orthanc.
You can also use the standard command-line tool storescu
from theDCMTK software to manuallysend DICOM images to Orthanc, for instance:
$ storescu -aec ORTHANC localhost 4242 *.dcm
will send all the files with “.dcm” extension to the instance ofOrthanc that is running on the localhost
, whose application entitytitle (AET) is ORTHANC
, and whose DICOM port is4242
. Obviously, all these parameters depend on yourconfiguration. Please check the FAQ if you encounter any problem.
Next steps¶
Read the general introduction “Understanding DICOM with Orthanc”.
Have a look at your configuration file.
Drive Orthanc through its REST API.
Automate DICOM tasks with Lua scripts.