Docker env configuration¶
Document not ready for translation
.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.
Variables that should always be changed¶
Set a new secret key. Create your own, or generate one by using a tool like http://www.miniwebtool.com/django-secret-key-generator/ for this:
DJANGO_ALLOWED_HOSTS is a string of hostnames or IPs with a space between each:
nginxis 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.
DJANGO_ALLOWED_HOSTS=nginx localhost 127.0.0.1 [::1] myservername
DJANGO_ALLOWED_HOSTS=nginx localhost 127.0.0.1 [::1]
Variables to help with debugging problems¶
Set to 1 to enable Django debugging mode.
Set the log level. Options are
progressively less logging.
LOG_LEVEL= LOG_LEVEL_QRSCU= LOG_LEVEL_EXTRACTOR=
Variables to be changed for your environment¶
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 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_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.
EMAIL_USE_SSL options should be configured to match the encryption requirements of
the e-mail server. Use
0 for False (default) and
1 for True. Only one of these options should be set to
EMAIL_DOSE_ALERT_SENDER should contain the e-mail address that you want to use as the sender address.
EMAIL_OPENREM_URL must contain the URL of your OpenREM installation in order for hyperlinks in the e-mail
alert messages to function correctly.
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:
Language code for this installation. All choices can be found here: http://www.i18nguy.com/unicode/language-identifiers.html
If you set this to False, Django will make some optimizations so as not to load the internationalization machinery:
If you set this to False, Django will not format dates, numbers and calendars according to the current locale:
If you set this to False (default), Django will not use timezone-aware datetimes:
XLSX date and time settings for exports:
Virtual directory settings¶
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