|
0
|
1 .. _configuration:
|
|
|
2 .. highlight:: bash
|
|
|
3
|
|
|
4 Configuration of Orthanc
|
|
|
5 ========================
|
|
|
6
|
|
213
|
7 Configuring Orthanc simply consists in providing a configuration file.
|
|
|
8 Orthanc has numerous configuration that are documented in the `default
|
|
|
9 configuration file
|
|
220
|
10 <https://bitbucket.org/sjodogne/orthanc/raw/Orthanc-1.5.6/Resources/Configuration.json>`_. This
|
|
0
|
11 file is in the `JSON <https://en.wikipedia.org/wiki/JSON>`_ file
|
|
213
|
12 format. You can generate this file file with the
|
|
0
|
13 following call::
|
|
|
14
|
|
|
15 $ Orthanc --config=Configuration.json
|
|
|
16
|
|
|
17 The default configuration file would:
|
|
|
18
|
|
|
19 * Create a DICOM server with the DICOM AET (Application Entity Title)
|
|
|
20 ``ORTHANC`` that listens on the port 4242.
|
|
|
21 * Create a HTTP server for the REST API that listens on the port 8042.
|
|
|
22 * Store the Orthanc database in a folder called ``OrthancStorage``.
|
|
|
23
|
|
213
|
24 However, we recommend that you start from an empty configuration file
|
|
|
25 and only specify the options for which you don't wan't to use
|
|
214
|
26 the default value. In example, a simple configuration file would be::
|
|
213
|
27
|
|
|
28 {
|
|
|
29 "Name": "My archive",
|
|
|
30 "HttpPort": 80,
|
|
|
31 "DicomAet": "ARCHIVE",
|
|
|
32 "DicomPort": 104
|
|
|
33 }
|
|
|
34
|
|
|
35 It's also a very good practice to split your configuration files per topic.
|
|
214
|
36 In example, have a ``dicom.json`` for everything that is related to DICOM,
|
|
213
|
37 a ``http.json`` for all HTTP related configurations, one file per plugin...
|
|
|
38 This is how the configuration files are provided with the Windows Installer.
|
|
|
39
|
|
|
40 Once your configuration file is ready, start Orthanc by giving it the path to the
|
|
|
41 configuration file path as a command-line argument. If you use multiple configuration
|
|
|
42 files, you may provide the path to the folder containing all configuration files
|
|
|
43 (all ``.json`` files will be loaded)::
|
|
|
44
|
|
|
45 $ Orthanc ./Configuration.json
|
|
|
46 $ Orthanc ./config/
|
|
|
47
|
|
|
48
|
|
73
|
49 *Remark:* When specifying paths under Microsoft Windows, backslashes
|
|
|
50 (i.e. ``\``) should be either escaped by doubling them (as in ``\\``),
|
|
|
51 or replaced by forward slashes (as in ``/``).
|
|
213
|
52 *Remark:* When installing Orthanc with the Windows Installer, you won't be
|
|
|
53 able to edit your files unless you start your editor with ``Run as administrator``.
|
|
|
54 We recommend to edit your configuration file with an editor such as `Notepad++ <https://notepad-plus-plus.org/>`_.
|
|
|
55 It shall warn you that this file can be edited only by an admin, and will suggest you
|
|
|
56 to restart Notepad++ as an admin such that you'll be able to save it.
|
|
73
|
57
|
|
213
|
58
|
|
0
|
59 To obtain more diagnostic, you can use the ``--verbose`` or the
|
|
|
60 ``--trace`` options::
|
|
|
61
|
|
|
62 $ Orthanc ./Configuration.json --verbose
|
|
|
63 $ Orthanc ./Configuration.json --trace
|
|
|
64
|
