Docker env configuration

Edit the .env.prod file to customise your installation. There should be no space between the variable name, the = and the value. Everything after the = until the end of the line is transferred as the value. These settings take effect when docker-compose is started or restarted.

Variablen, die auf alle Fälle angepasst werden sollten

Wert für den geheimen Schlüssel festlgen. Entweder selbst erstellen oder über Tools wie http://www.miniwebtool.com/django-secret-key-generator/ generieren lassen:

SECRET_KEY=

DJANGO_ALLOWED_HOSTS is a string of hostnames or IPs with a space between each:

  • nginx is required for internal use

  • localhost 127.0.0.1 [::] allows access on the server using the localhost name or IP (using IPv4 or IPv6)

  • add the name and/or IP address of your server so it can be accessed from other computers on your network.

For example: DJANGO_ALLOWED_HOSTS=nginx localhost 127.0.0.1 [::1] myservername

DJANGO_ALLOWED_HOSTS=nginx localhost 127.0.0.1 [::1]

Variablen, die bei Problemen bei der Fehlersuche helfen

Set to 1 to enable Django debugging mode.

DEBUG=

Set the log level. Options are DEBUG, INFO, WARNING, ERROR, and CRITICAL, with progressively less logging.

LOG_LEVEL=
LOG_LEVEL_QRSCU=
LOG_LEVEL_EXTRACTOR=

Variablen, die an die eigene Ümgebung angepasst werden sollten

E-mail server settings

EMAIL_HOST=
EMAIL_PORT=
EMAIL_HOST_USER=
EMAIL_HOST_PASSWORD=
EMAIL_USE_TLS=
EMAIL_USE_SSL=
EMAIL_DOSE_ALERT_SENDER=
EMAIL_OPENREM_URL=

The host name and port of the e-mail server that you wish to use must be entered in the EMAIL_HOST and EMAIL_PORT fields. EMAIL_HOST might be your institution’s Outlook/Exchange server.

If the e-mail server is set to only allow authenticated users to send messages then a suitable user and password must be entered in the EMAIL_HOST_USER and EMAIL_HOST_PASSWORD fields. If this approach is used then it may be useful to request that an e-mail account be created specifically for sending these OpenREM alert messages.

It may be possible to configure the e-mail server to allow sending of messages that originate from the OpenREM server without authentication, in which case the user and password settings should not be required.

Die Optionen EMAIL_USE_TLS und EMAIL_USE_SSL sollten gemäß den Vorgaben zur Verschlüsselung auf dem E-Mail Server konfiguriert werden. Verwenden Sie eine 0 (Standard) wenn dies nicht zutrifft und 1 wenn dies Option verwendet werden soll. Nur jeweils eine der beiden Optionen sollte auf 1 gesetzt werden.

The EMAIL_DOSE_ALERT_SENDER should contain the e-mail address that you want to use as the sender address.

The EMAIL_OPENREM_URL must contain the URL of your OpenREM installation in order for hyperlinks in the e-mail alert messages to function correctly.

Regionalisierung

Local time zone for this installation. Choices can be found here: http://en.wikipedia.org/wiki/List_of_tz_zones_by_name although not all choices may be available on all operating systems:

TIME_ZONE=Europe/London

Sprach-Code für die Installation. Mögliche Werte finden sich unter: http://www.i18nguy.com/unicode/language-identifiers.html

LANGUAGE_CODE=en-us

Wird dieser Wert auf Falsch gestellt, wird Django einige Optimierungen durchführen:

USE_I18N=True

Wird dieser Wert auf False gesetzt, wird Django die Formate für Datum, Zahlen und Kalenderdaten nicht anhand der aktuellen Lokalisierung ändern:

USE_L10N=True

Wird dieser Wert auf False (Standard) gesetzt, wird Django die zeitzonenbezogenen Datumsangaben nicht verwenden:

USE_TZ=False

XLSX date and time settings for exports:

XLSX_DATE=dd/mm/yyyy
XLSX_TIME=hh:mm:ss

Einstellungen für den virtuellen Ordner

See Running the OpenREM website in a virtual directory for details of these variables - normally these can be left commented out.

Device Observer UID settings

OpenREM users have found one x-ray system which incorrectly sets the Device Observer UID to be equal to the Study Instance UID. In this situation a new entry is created in the display name settings for every new exam that arrives in OpenREM, making the display name table fill with many duplicate entries for the same system. To avoid this problem a list of models can be specified using the variable below - OpenREM will ignore the Device Observer UID value when creating new display names for any model in this list. The model name text must exactly match what is contained in the system’s Manufacturer’s Model Name DICOM tag (0008,1090).

IGNORE_DEVICE_OBSERVER_UID_FOR_THESE_MODELS = ['GE OEC Fluorostar']

Variables that should only be changed if you know what you are doing

## Database settings
SQL_HOST=db
SQL_ENGINE=django.db.backends.postgresql
SQL_PORT=5432
DATABASE=postgres
POSTGRES_USER=openremuser
POSTGRES_PASSWORD=openrem_pass
POSTGRES_DB=openrem_prod

## Paths
MEDIA_ROOT=/home/app/openrem/mediafiles
STATIC_ROOT=/home/app/openrem/staticfiles
LOG_ROOT=/logs

Variables that shouldn’t be changed

Changing this will mean some OpenREM functions will fail

DOCKER_INSTALL=1