Mercurial > hg > orthanc-book

annotate Sphinx/source/users/docker-orthancteam.rst @ 1061:7c6b752c2e30

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fix link
author Alain Mazy <am@orthanc.team>
date Mon, 15 Apr 2024 10:45:32 +0200
parents a4953b6ab979
children 202b378001f0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1023
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
1 .. _docker-orthancteam:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
2 .. highlight:: bash
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
3
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
4
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
5 orthancteam/orthanc Docker images
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
6 =================================
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
7
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
8 .. contents::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
9 :depth: 3
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
10
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
11 .. warning::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
12 Starting from February 2024, the ``osimis/orthanc`` Docker images have been renamed
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
13 into ``orthancteam/orthanc``. The ``osimis/orthanc`` images won't be updated anymore
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
14 therefore you should switch to the ``orthancteam/orthanc`` images.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
15
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
16 Note that all old tags released prior to February 2024 have been copied into ``orthancteam/orthanc``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
17 as well so, even if you are using an old version, you should update the name in your setup.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
18 The name is the only thing that has changed. The content and build procedure are identical.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
19
1040
16e4ee083319 link to new md release notes
Alain Mazy <am@osimis.io>
parents: 1023
diff changeset
20 The ``orthancteam/orthanc`` images are updated regularly. The release notes are available `here <https://github.com/orthanc-server/orthanc-builder/blob/master/release-notes-docker-images.md>`__.
16e4ee083319 link to new md release notes
Alain Mazy <am@osimis.io>
parents: 1023
diff changeset
21
1023
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
22 .. warning::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
23
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
24 Starting from the ``22.6.1`` release, we are providing 2 types of images:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
25
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
26 - the default image with the usual tag: e.g ``22.6.1``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
27 - the full image with a e.g ``22.6.1-full`` tag
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
28
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
29 The default image is suitable for 99.9% of users.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
30
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
31 You should use the full image only if you need to use one of these:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
32
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
33 - the Azure Blob storage plugin
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
34 - the Google Cloud storage plugin
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
35 - the ODBC plugin with SQL Server (msodbcsql18 is preinstalled)
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
36
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
37
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
38 Introduction
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
39 ------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
40
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
41 Our commercial partner `Orthanc Team <https://orthanc.team>`__
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
42 `publishes separated Docker images
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
43 <https://hub.docker.com/r/orthancteam/orthanc>`__.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
44 These images have been designed to be used with ``docker-compose`` and
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
45 provide a configuration system through:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
46
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
47 - environment variables
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
48 - Docker secrets
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
49 - classical configuration files
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
50 - a mix of these options
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
51
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
52 This `repository <https://github.com/orthanc-server/orthanc-setup-samples/src>`__
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
53 contains lots of examples on how to use these images. In particular,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
54 `this example <https://github.com/orthanc-server/orthanc-setup-samples/tree/master/docker/all-usages/docker-compose.yml>`__
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
55 shows all the way that can be used to generate the same
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
56 configuration in Orthanc.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
57
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
58
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
59 Environment variables
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
60 ---------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
61
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
62 Any part of the Orthanc configuration file can be configured through an
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
63 environment variable. Now that Orthanc and its plugins have hundreds of
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
64 configuration parameter, listing all these environment variable would be
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
65 too long. That's why we have defined a standard way of naming the variable:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
66
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
67 +---------------------------+----------------------------------------------+----------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
68 | Orthanc configuration | Environment variable | Sample value |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
69 +===========================+==============================================+================================================================+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
70 | StableAge | ORTHANC__STABLE_AGE | ``30`` |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
71 +---------------------------+----------------------------------------------+----------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
72 | DicomWeb.Root | ORTHANC__DICOM_WEB__ROOT | ``/dicom-web/`` |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
73 +---------------------------+----------------------------------------------+----------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
74 | DicomWeb.Servers | ORTHANC__DICOM_WEB__SERVERS | ``{"sample": [ "http://127.0.0.1/dicom-web/"]}`` |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
75 +---------------------------+----------------------------------------------+----------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
76
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
77 To find out an environment variable name from an Orthanc setting
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
78 (i.e. ``DicomWeb.StudiesMetadata`` is the ``path`` to a setting):
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
79
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
80 - whenever a word contains a capital letter, insert an underscore ``_`` in front.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
81 ``DicomWeb.StudiesMetadata`` now becomes ``Dicom_Web.Studies_Metadata``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
82 - whenever you go down one level in the JSON configuration, insert
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
83 a double underscore ``__``. ``Dicom_Web.Studies_Metadata`` now becomes
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
84 ``Dicom_Web__Studies_Metadata``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
85 - capitalize all letters. ``Dicom_Web__Studies_Metadata`` now becomes
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
86 ``DICOM_WEB__STUDIES_METADATA``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
87 - add ``ORTHANC__`` in front. ``DICOM_WEB__STUDIES_METADATA`` now becomes
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
88 ``ORTHANC__DICOM_WEB__STUDIES_METADATA``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
89
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
90 Note that, this automatic rule might fail because of 2 capital letters one after each other in some
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
91 Orthanc settings. Therefore, there are some `exceptions <https://github.com/orthanc-server/orthanc-builder/blob/master/docker/orthanc/env-var-non-standards.json>`__ to this rule
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
92 that are however quite intuitive.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
93
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
94 Special environment variables
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
95 -----------------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
96
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
97 Other environment variables are not related to the Orthanc configuration file
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
98 but can be specified to control the way Orthanc is run.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
99
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
100 - ``VERBOSE_STARTUP=true`` will allow you to debug the startup process and see
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
101 the configuration that has been provided to Orthanc. This setup should be
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
102 disabled in production since it might display secret information like passwords
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
103 in your logs
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
104 - ``VERBOSE_ENABLED=true`` will start Orthanc with the ``--verbose`` option
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
105 - ``TRACE_ENABLED=true`` will start Orthanc with the ``--trace`` option
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
106 - ``NO_JOBS=true`` will start Orthanc with the ``--no-jobs`` option
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
107 - ``LOGDIR=/logs`` will start Orthanc with the ``--logdir=/logs`` option (introduced in 21.9.1)
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
108 - ``LOGFILE=/logs`` will start Orthanc with the ``--logfile=/logs/orthanc.log`` option (introduced in 21.9.1)
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
109 - ``MALLOC_ARENA_MAX=10`` will :ref:`control memory usage <scalability-memory>`
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
110 - ``ORTHANC_JSON`` can be used to pass a JSON "root" configuration (see below).
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
111 - ``BEFORE_ORTHANC_STARTUP_SCRIPT`` can be used to `run a custom script <https://groups.google.com/g/orthanc-users/c/EXjTq2ZU1vw/m/02CwW1jzAQAJ>`__ before starting Orthanc.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
112 - ``FORCE_HOST_ID`` and ``GENERATE_HOST_ID_IF_MISSING`` can be used to control the content of /etc/hostid (introduced in 22.9.1).
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
113 DCMTK calls gethostid() when generating DICOM UIDs (used, e.g, in modifications/anonymizations).
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
114 When /etc/hostid is missing, the system tries to generate it from the IP of the system.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
115 On some system, in particular circumstances, we have observed that the system performs a DNS query
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
116 to get the IP of the system. This DNS can timeout (after multiple with retries) and, in particular cases,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
117 we have observed a delay of 40 seconds to generate a single DICOM UID in Orthanc.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
118 Therefore, if /etc/hostid is missing, the startup script creates it and fill it with a random number (default behaviour).
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
119 This behaviour can still be deactivated by defining ``GENERATE_HOST_ID_IF_MISSING=false``.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
120 The host id can also be forced by defining ``FORCE_HOST_ID``.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
121
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
122
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
123
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
124 Configuration files
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
125 -------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
126
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
127 .. highlight:: yaml
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
128
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
129 Configuration files should be stored in the ``/etc/orthanc/`` folder inside the Docker image.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
130 This is done by building an image thanks to a ``Dockerfile``::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
131
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
132 FROM orthancteam/orthanc
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
133 COPY orthanc.json /etc/orthanc/
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
134
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
135
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
136 Configuration files can also be passed as secrets as shown in this ``docker-compose.yml``::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
137
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
138 version: "3.3"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
139 services:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
140 orthanc-file-in-secrets:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
141 image: orthancteam/orthanc
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
142 depends_on: [index-db]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
143 ports: ["8201:8042"]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
144 environment:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
145 VERBOSE_STARTUP: "true"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
146
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
147 secrets:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
148 - orthanc.secret.json
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
149
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
150 secrets:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
151 orthanc.secret.json:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
152 file: orthanc.secret.json
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
153
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
154 Finally, a whole configuration file can be passed as a JSON through the ``ORTHANC_JSON`` environment variable::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
155
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
156 version: "3.3"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
157 services:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
158 orthanc-file-in-env-var:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
159 image: orthancteam/orthanc
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
160 depends_on: [index-db]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
161 ports: ["8200:8042"]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
162 environment:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
163 VERBOSE_ENABLED: "true"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
164 OSIMIS_WEB_VIEWER1_PLUGIN_ENABLED: "true"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
165
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
166 ORTHANC_JSON: |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
167 {
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
168 "Name": "orthanc-file-in-env-var",
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
169 "PostgreSQL" : {
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
170 "Host": "index-db",
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
171 "Password": "pg-password"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
172 },
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
173 "RegisteredUsers": {
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
174 "demo": "demo"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
175 }
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
176 }
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
177
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
178
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
179 Docker secrets
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
180 --------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
181
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
182 .. highlight:: yaml
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
183
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
184 When using your container in a ``Docker Swarm`` or ``Kubernetes`` environment,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
185 it is usually advised to pass sensitive information through ``Docker Secrets``.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
186 For this purpose, any secret whose name is similar to the name of an
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
187 environment variable is considered as an environment variable::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
188
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
189 version: "3.3"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
190 services:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
191 orthanc-with-direct-secret:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
192 image: orthancteam/orthanc
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
193 depends_on: [index-db]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
194 ports: ["8003:8042"]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
195 environment:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
196 ORTHANC__NAME: "orthanc-with-direct-secret"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
197 VERBOSE_ENABLED: "true"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
198
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
199 OSIMIS_WEB_VIEWER1_PLUGIN_ENABLED: "true"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
200
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
201 ORTHANC__POSTGRESQL__HOST: "index-db"
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
202 ORTHANC__REGISTERED_USERS: |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
203 {"demo": "demo"}
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
204
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
205 secrets:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
206 - ORTHANC__POSTGRESQL__PASSWORD
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
207 secrets:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
208 ORTHANC__POSTGRESQL__PASSWORD:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
209 file: ORTHANC__POSTGRESQL__PASSWORD
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
210
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
211
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
212 Mixing configuration
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
213 --------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
214
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
215 Parts of your configuration can be defined in a configuration file,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
216 another part in an environment variable and yet another in a secret.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
217 If the same setting is defined in multiple location, the latest one
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
218 will overwrite the first. Settings are evaluated in this order:
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
219
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
220 - JSON files from ``/etc/orthanc/``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
221 - JSON files from ``/run/secrets`` (Docker secrets are copied there
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
222 by Docker)
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
223 - environment variables
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
224 - secret environment variables
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
225
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
226 At this point, if some settings have not been defined yet, some defaults
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
227 are applied (see below).
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
228
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
229
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
230 Default configuration
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
231 ---------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
232
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
233 .. highlight:: json
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
234
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
235 Orthanc and each plugin might have some default settings that might
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
236 eventually be different from the defaults included in the Orthanc
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
237 executable or the plugin library.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
238
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
239 .. below json is copied from orthanc-builder/docker/orthanc/orthanc-defaults.json
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
240
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
241 Orthanc non-standard defaults::
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
242
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
243 {
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
244 "StorageDirectory" : "/var/lib/orthanc/db",
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
245
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
246 "RemoteAccessAllowed": true,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
247 "AuthenticationEnabled": true,
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
248
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
249 "HttpsCACertificates" : "/etc/ssl/certs/ca-certificates.crt",
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
250
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
251 "Plugins" : ["/usr/share/orthanc/plugins/"]
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
252 }
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
253
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
254
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
255 Default Lua scripts
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
256 -------------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
257
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
258 Some Lua scripts are already loaded in the image but are not configured to
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
259 be loaded by Orthanc automatically. You'll have to add them to the ``"LuaScripts"``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
260 configuration if you want to use them.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
261
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
262 `/lua-scripts/filter-http-tools-reset.lua <https://github.com/orthanc-server/orthanc-builder/blob/master/docker/orthanc/filter-http-tools-reset.lua>`__
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
263 can be used to regenerate the ``/tmp/orthanc.json`` configuration file that is loaded by Orthanc every time
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
264 you POST to ``/tools/reset``. Note that it declares an ``IncomingHttpRequestFilter``
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
265 callback that might conflict with your scripts.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
266
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
267 Healthcheck probe
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
268 -----------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
269
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
270 In version 21.10.0, the `/probes/test-aliveness.py <https://github.com/orthanc-server/orthanc-builder/blob/master/docker/orthanc/test-aliveness.py>`__
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
271 script has been added in order to perform healthchecks. Check the doc in the script itself for more details.
1061
7c6b752c2e30 fix link
Alain Mazy <am@orthanc.team>
parents: 1060
diff changeset
272 A sample configuration is also available in `this sample <https://github.com/orthanc-server/orthanc-setup-samples/tree/master/docker/health-check>`__
1023
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
273
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
274
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
275 Plugins
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
276 -------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
277
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
278 Plugins are automatically enabled as soon as you define a setting
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
279 in their JSON section or as soon as you define to ``true`` their
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
280 specific environment variable.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
281
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
282 Below is a list of all plugins, their environment variable and their default configuration
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
283 (only when their default configuration is different from the plugin defaults):
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
284
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
285
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
286 .. below table is obtained by running orthanc-builder/docker/orthanc/generatePluginDoc.py
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
287
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
288
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
289 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
290 | Plugin | Environment variable | Default configuration |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
291 +==================================================+==================================================+====================================================================================================+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
292 | **Authorization** | ``AUTHORIZATION_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
293 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
294 | **ConnectivityChecks** | ``CONNECTIVITY_CHECKS_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
295 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
296 | **DicomWeb** | ``DICOM_WEB_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
297 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
298 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
299 | | | "DicomWeb": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
300 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
301 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
302 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
303 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
304 | **Gdcm** | ``GDCM_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
305 | | Note: enabled by default | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
306 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
307 | | | "Gdcm": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
308 | | | "Throttling": 4, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
309 | | | "RestrictTransferSyntaxes": [ |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
310 | | | "1.2.840.10008.1.2.4.90", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
311 | | | "1.2.840.10008.1.2.4.91", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
312 | | | "1.2.840.10008.1.2.4.92", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
313 | | | "1.2.840.10008.1.2.4.93" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
314 | | | ] |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
315 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
316 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
317 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
318 | **OrthancWebViewer** | ``ORTHANC_WEB_VIEWER_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
319 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
320 | **StoneWebViewer** | ``STONE_WEB_VIEWER_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
321 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
322 | **OsimisWebViewerBasic** | ``OSIMIS_WEB_VIEWER1_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
323 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
324 | **OsimisWebViewerBasicAlpha** | ``OSIMIS_WEB_VIEWER1_ALPHA_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
325 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
326 | **PostgreSQL** | ``POSTGRESQL_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
327 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
328 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
329 | | | "PostgreSQL": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
330 | | | "EnableIndex": true, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
331 | | | "EnableStorage": false, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
332 | | | "Port": 5432, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
333 | | | "Host": "HOST MUST BE DEFINED", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
334 | | | "Database": "postgres", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
335 | | | "Username": "postgres", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
336 | | | "Password": "postgres", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
337 | | | "EnableSsl": false, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
338 | | | "Lock": false |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
339 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
340 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
341 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
342 | **MySQL** | ``MYSQL_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
343 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
344 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
345 | | | "MySQL": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
346 | | | "EnableIndex": true, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
347 | | | "EnableStorage": false, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
348 | | | "Port": 3306, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
349 | | | "Host": "HOST MUST BE DEFINED", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
350 | | | "Database": "mysql", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
351 | | | "Username": "root", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
352 | | | "Password": "mysql", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
353 | | | "Lock": false |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
354 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
355 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
356 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
357 | **Python** | ``PYTHON_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
358 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
359 | **ServeFolders** | ``SERVE_FOLDERS_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
360 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
361 | **Transfers** | ``TRANSFERS_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
362 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
363 | **Worklists** | ``WORKLISTS_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
364 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
365 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
366 | | | "Worklists": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
367 | | | "Enable": true, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
368 | | | "Database": "/var/lib/orthanc/worklists" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
369 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
370 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
371 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
372 | **Housekeeper** | ``HOUSEKEEPER_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
373 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
374 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
375 | | | "Housekeeper": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
376 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
377 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
378 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
379 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
380 | **DelayedDeletion** | ``DELAYED_DELETION_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
381 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
382 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
383 | | | "DelayedDeletion": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
384 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
385 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
386 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
387 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
388 | **MultitenantDicom** | ``MULTITENANT_DICOM_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
389 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
390 | **Wsi** | ``WSI_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
391 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
392 | **Odbc** | ``ODBC_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
393 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
394 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
395 | | | "Odbc": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
396 | | | "EnableIndex": true, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
397 | | | "EnableStorage": false, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
398 | | | "IndexConnectionString": "MUST BE DEFINED", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
399 | | | "StorageConnectionString": "MUST BE DEFINED" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
400 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
401 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
402 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
403 | **Tcia** | ``TCIA_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
404 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
405 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
406 | | | "Tcia": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
407 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
408 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
409 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
410 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
411 | **Indexer** | ``INDEXER_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
412 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
413 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
414 | | | "Indexer": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
415 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
416 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
417 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
418 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
419 | **Neuro** | ``NEURO_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
420 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
421 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
422 | | | "Neuro": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
423 | | | "Enable": true |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
424 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
425 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
426 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
427 | **AzureBlobStorage** | ``AZURE_BLOB_STORAGE_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
428 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
429 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
430 | | | "AzureBlobStorage": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
431 | | | "ConnectionString": "MUST BE DEFINED BY YOU", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
432 | | | "ContainerName": "MUST BE DEFINED BY YOU" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
433 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
434 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
435 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
436 | **AwsS3Storage** | ``AWS_S3_STORAGE_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
437 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
438 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
439 | | | "AwsS3Storage": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
440 | | | "BucketName": "MUST BE DEFINED BY YOU", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
441 | | | "Region": "MUST BE DEFINED BY YOU" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
442 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
443 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
444 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
445 | **GoogleCloudStorage** | ``GOOGLE_CLOUD_STORAGE_PLUGIN_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
446 | | | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
447 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
448 | | | "GoogleCloudStorage": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
449 | | | "ServiceAccountFile": "MUST BE DEFINED BY YOU", |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
450 | | | "BucketName": "MUST BE DEFINED BY YOU" |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
451 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
452 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
453 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
454 | **OrthancExplorer2** | ``ORTHANC_EXPLORER_2_ENABLED`` | .. code-block:: json |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
455 | | Note: enabled by default | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
456 | | | { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
457 | | | "OrthancExplorer2": { |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
458 | | | "Enable": true, |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
459 | | | "IsDefaultOrthancUI": false |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
460 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
461 | | | } |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
462 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
463 | **VolView** | ``VOLVIEW_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
464 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
465 | **Ohif** | ``OHIF_PLUGIN_ENABLED`` | |
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
466 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
1053
600547006d14 added STL_PLUGIN_ENABLED
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1040
diff changeset
467 | **STL** | ``STL_PLUGIN_ENABLED`` | |
600547006d14 added STL_PLUGIN_ENABLED
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1040
diff changeset
468 +--------------------------------------------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------+
1023
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
469
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
470
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
471 Under the hood
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
472 --------------
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
473
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
474 The source code that is used to generate the image can be found `here <https://github.com/orthanc-server/orthanc-builder/blob/master/docker/orthanc/Dockerfile>`__.
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
475
5d4701d8fe28 replaced osimis/orthanc by orthancteam/orthanc
Alain Mazy <am@osimis.io>
parents:
diff changeset
476 The Python script that is used at startup can be found `here <https://github.com/orthanc-server/orthanc-builder/blob/master/docker/orthanc/generateConfiguration.py>`__