- How To Install orthanc on Ubuntu 20.04
- What is orthanc
- Install orthanc Using apt-get
- Install orthanc Using apt
- Install orthanc Using aptitude
- How To Uninstall orthanc on Ubuntu 20.04
- Uninstall orthanc And Its Dependencies
- Remove orthanc Configurations and Data
- Remove orthanc configuration, data, and all of its dependencies
- References
- Summary
- orthanc on Ubuntu 21.10 (Impish Indri)
- 2. Uninstall / Remove orthanc package
- 3. Details of orthanc package
- 4. References on Ubuntu 21.10 (Impish Indri)
- 5. The same packages on other Linux Distributions
- Quickstart¶
- Opening Orthanc Explorer¶
- Uploading DICOM files¶
- Uploading through the DICOM protocol¶
- Next steps¶
How To Install orthanc on Ubuntu 20.04
In this tutorial we learn how to install orthanc on Ubuntu 20.04.
What is orthanc
Orthanc aims at providing a simple, yet powerful DICOM server for medical imaging. Orthanc can turn any computer running Windows or Linux into a Vendor Neutral Archive (in other words, a mini-PACS system). Its architecture is lightweight, meaning that no complex database administration is required, nor the installation of third-party dependencies.
What makes Orthanc unique is the fact that it provides a RESTful API. Thanks to this major feature, it is possible to drive Orthanc from any computer language. The DICOM tags of the stored medical images can be downloaded in the JSON file format. Furthermore, standard PNG images can be generated on-the-fly from the DICOM instances by Orthanc.
Orthanc lets its users focus on the content of the DICOM files, hiding the complexity of the DICOM format and of the DICOM protocol. Description-md5: 583441f4d2fe9fa37be1da8d3a612ce1
There are three ways to install orthanc on Ubuntu 20.04. We can use apt-get , apt and aptitude . In the following sections we will describe each method. You can choose one of them.
Install orthanc Using apt-get
Update apt database with apt-get using the following command.
After updating apt database, We can install orthanc using apt-get by running the following command:
sudo apt-get -y install orthanc
Install orthanc Using apt
Update apt database with apt using the following command.
After updating apt database, We can install orthanc using apt by running the following command:
sudo apt -y install orthanc
Install orthanc Using aptitude
If you want to follow this method, you might need to install aptitude first since aptitude is usually not installed by default on Ubuntu. Update apt database with aptitude using the following command.
After updating apt database, We can install orthanc using aptitude by running the following command:
sudo aptitude -y install orthanc
How To Uninstall orthanc on Ubuntu 20.04
To uninstall only the orthanc package we can use the following command:
sudo apt-get remove orthanc
Uninstall orthanc And Its Dependencies
To uninstall orthanc and its dependencies that are no longer needed by Ubuntu 20.04, we can use the command below:
sudo apt-get -y autoremove orthanc
Remove orthanc Configurations and Data
To remove orthanc configuration and data from Ubuntu 20.04 we can use the following command:
sudo apt-get -y purge orthanc
Remove orthanc configuration, data, and all of its dependencies
We can use the following command to remove orthanc configurations, data and all of its dependencies, we can use the following command:
sudo apt-get -y autoremove --purge orthanc
References
Summary
In this tutorial we learn how to install orthanc package on Ubuntu 20.04 using different package management tools: apt, apt-get and aptitude.
orthanc on Ubuntu 21.10 (Impish Indri)
This guide covers the steps necessary to install orthanc package:
2. Uninstall / Remove orthanc package
Please follow the steps below to uninstall orthanc package:
3. Details of orthanc package
Package: orthanc
Architecture: amd64
Version: 1.9.2+really1.9.1+dfsg-1
Priority: optional
Section: universe/science
Origin: Ubuntu
Maintainer: Ubuntu Developers
Original-Maintainer: Debian Med Packaging Team
Bugs: https://bugs.launchpad.net/ubuntu/+filebug
Installed-Size: 4449
Pre-Depends: init-system-helpers (>= 1.54~)
Depends: adduser, dcmtk, locales, libcivetweb1 (>= 1.13+dfsg-3), lsb-base, tzdata, libboost-filesystem1.74.0 (>= 1.74.0), libboost-iostreams1.74.0 (>= 1.74.0), libboost-locale1.74.0 (>= 1.74.0), libboost-regex1.74.0-icu67, libboost-thread1.74.0 (>= 1.74.0), libc6 (>= 2.17), libcurl4 (>= 7.16.2), libdcmtk15 (>= 3.6.5), libgcc-s1 (>= 3.3.1), libjpeg8 (>= 8c), libjsoncpp24 (>= 1.9.4), liblua5.3-0, libpng16-16 (>= 1.6.2-1), libpugixml1v5 (>= 1.6), libsqlite3-0 (>= 3.7.3), libssl1.1 (>= 1.1.0), libstdc++6 (>= 9), libuuid1 (>= 2.16), zlib1g (>= 1:1.2.0)
Filename: pool/universe/o/orthanc/orthanc_1.9.2+really1.9.1+dfsg-1_amd64.deb
Size: 1330964
MD5sum: fbdc297057458bae32db4b8155e37477
SHA1: 7a577c0212d1712c6b97902b8b801174c23d0a99
SHA256: 8c2ec376e93f8527570e782c5d7e4fbdab216f771d23b9791861992c1e2c1e43
SHA512: 6bc9d23df1cf7081294b24ece9cf394c01f7ebfbebe415f0c7daac8aa4081a1004e0479a4f0168c0731790d651ea4cd9d5de3a311c6cca68d712664d9b2addae
Homepage: http://www.orthanc-server.com/
Description-en: Lightweight, RESTful DICOM server for medical imaging
Orthanc aims at providing a simple, yet powerful DICOM server for
medical imaging. Orthanc can turn any computer running Windows or
Linux into a Vendor Neutral Archive (in other words, a mini-PACS
system). Its architecture is lightweight, meaning that no complex
database administration is required, nor the installation of
third-party dependencies.
.
What makes Orthanc unique is the fact that it provides a RESTful
API. Thanks to this major feature, it is possible to drive Orthanc
from any computer language. The DICOM tags of the stored medical
images can be downloaded in the JSON file format. Furthermore,
standard PNG images can be generated on-the-fly from the DICOM
instances by Orthanc.
.
Orthanc lets its users focus on the content of the DICOM files,
hiding the complexity of the DICOM format and of the DICOM protocol.
Description-md5: 583441f4d2fe9fa37be1da8d3a612ce1
4. References on Ubuntu 21.10 (Impish Indri)
orphan-sysvinit-scripts (0.07)
orpie (1.6.1-1)
orthanc-dev (1.9.2+really1.9.1+dfsg-1)
orthanc-dicomweb (1.5+dfsg-3)
orthanc-doc (1.9.2+really1.9.1+dfsg-1)
orthanc-mysql (3.0-1)
orthanc-wsi (1.0-3)
os-brick-common (5.0.1-0ubuntu1)
os8 (2.1-7)
osc (0.169.1-1)
oscar (1.2.0-1)
osdclock (0.5-24)
osdlyrics (0.5.5~rc2+dfsg1-2)
osinfo-db-tools (1.1.0-1build1)
osinfo-db (0.20210903-1)
osk-sdl (0.62.1-2)
5. The same packages on other Linux Distributions
orthanc (1.3.1+dfsg-1build2) Ubuntu 18.04 LTS (Bionic Beaver)
orthanc (1.0.0+dfsg-1build1) Ubuntu 16.04 LTS (Xenial Xerus)
orthanc (1.9.6-bp153.2.7.1) openSUSE Leap
orthanc (1.9.7-3.3) openSuSE Tumbleweed
orthanc (1.10.0+dfsg-1) Ubuntu 22.04 LTS (Jammy Jellyfish)
orthanc (1.5.6+dfsg-1) Debian 10 (Buster)
Quickstart¶
To obtain the Orthanc binaries, you have several possibilities:
- Download pre-compiled packages.
- Use jodogne/orthanc Docker images .
- Use osimis/orthanc Docker images .
- On GNU/Linux, use precompiled packages for Debian/Ubuntu (courtesy of DebianMed and Sébastien Jodogne), or for openSUSE (courtesy of Axel Braun).
- On GNU/Linux, use our LSB binaries (Linux Standard Base), that should easily and immediately run on most distributions. Those binaries are statically linked together with all their third-party dependencies. Don’t forget to execute chmod +x ./Orthanc in order to be able to run the main Orthanc executable.
- Compile Orthanc by yourself .
- 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 an AMD64 architecture, Sébastien Jodogne maintains a standalone Debian repository that provides the latest versions of the LSB binaries. For instance, here is how to install the Stone Web viewer 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 the Python plugin , as this plugin must be dynamically linked against the system-wide version of your Python runtime. You should install the orthanc-python package from your native Debian/Ubuntu distribution if available, or compile the plugin from sources.
Opening Orthanc Explorer¶
The most straightforward way to use Orthanc consists in opening Orthanc Explorer, the embedded administrative interface of Orthanc, with a Web browser. Once Orthanc is running, open the following URL: http://localhost:8042/app/explorer.html. Please note that:
- The port number 8042 depends on your configuration .
- Orthanc Explorer does not work with Microsoft Internet Explorer. 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 upload DICOM files. You can reach the upload page at http://localhost:8042/app/explorer.html#upload. Then, you can drag and drop your DICOM files and click on the Upload button.
You can watch this video tutorial that shows how to upload files to Orthanc through Orthanc Explorer with Chromium.
Important: There is currently a known issue that might prevent Mozilla Firefox to correctly upload all DICOM files if using drag-and-drop.
Uploading through the DICOM protocol¶
Once Orthanc is up and running, any imaging modality can send instances to Orthanc through the DICOM protocol (with the C-Store command). Check this tutorial to connect your modality to Orthanc.
You can also use the standard command-line tool storescu from the DCMTK software to manually send DICOM images to Orthanc, for instance:
$ storescu -aec ORTHANC localhost 4242 *.dcm
will send all the files with ”.dcm” extension to the instance of Orthanc that is running on the localhost , whose application entity title (AET) is ORTHANC , and whose DICOM port is 4242 . Obviously, all these parameters depend on your configuration . 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 .
© Copyright 2015-2023, University Hospital of Liège, Osimis S.A. (Belgium), UCLouvain ICTEAM, and the Orthanc community
The Orthanc Book is licensed under Creative Commons CC-BY-SA 4.0.
Created using Sphinx 1.3.6.