Running on Docker

Docker images

Repository	Tag(s)	Description
dcm4che/slapd-dcm4chee	5.0.1	slapd with schemas and default configuration for dcm4chee-arc 5.x
dcm4che/postgres-dcm4chee	5.0.1	PostgreSQL for dcm4che-arc 5.x
dcm4che/dcm4chee-arc-psql	5.0.1, 5.0.1-secure, 5.0.1-secure-ui	dcm4chee-arc 5.x using PostgreSQL as DB

Docker Installation

Docker’s installation method differs based on your platform. You’ll want to review Docker’s Installation guides for your respective platforms.

To make things unified across the various platform, you may map dockerhost to the ip of where your docker instance is running.

By default on Linux that will be 127.0.0.1, so you would add the following line to your /etc/hosts file:

127.0.0.1 dockerhost

But on OSX and Windows it will be a unique IP you can get by running boot2docker ip (i.e. 192.168.59.122). In that case the following should be added:

192.168.59.122 dockerhost

From now on you can use dockerhost in all your applications and get to it no matter what OS you are running on.

Run OpenLDAP Server

Before running the Archive container, you have to start a container providing the LDAP server, e.g:

> $docker run --name slapd \
           -p 389:389 \
           -e LDAP_BASE_DN=dc=dcm4che,dc=org \
           -e LDAP_ORGANISATION=dcm4che.org \
           -e LDAP_ROOTPASS=secret \
           -e LDAP_CONFIGPASS=secret \
           -e DEVICE_NAME=dcm4chee-arc \
           -e AE_TITLE=DCM4CHEE \
           -e DICOM_HOST=dockerhost \
           -e DICOM_PORT=11112 \
           -e HL7_PORT=2575 \
           -e STORAGE_DIR=/storage/fs1 \
           -v /var/local/dcm4chee-arc/ldap:/var/lib/ldap \
           -v /var/local/dcm4chee-arc/slapd.d:/etc/ldap/slapd.d \
           -d dcm4che/slapd-dcm4chee:5.0.1

Run PostgreSQL Server

Before running the Archive container, you have to start a container providing the database server, e.g:

> $docker run --name postgres \
           -p 5432:5432 \
           -e POSTGRES_DB=pacsdb \
           -e POSTGRES_USER=pacs \
           -e POSTGRES_PASSWORD=pacs \
           -v /var/local/dcm4chee-arc/db:/var/lib/postgresql/data \
           -d dcm4che/postgres-dcm4chee:5.0.1

Run DCM4CHEE Archive 5

You may choose between

• a not secured version (Tag Name: 5.0.1),
• a version with secured UI and secured RESTful services (Tag Name: 5.0.1-secure) and
• a version with secured UI, but not secured RESTful services (Tag Name: 5.0.1-secure-ui).

You have to link the archive container with the OpenLDAP (alias:ldap) and the PostgreSQL (alias:db) container:

> $docker run --name dcm4chee-arc \
           -p 8080:8080 \
           -p 9990:9990 \
           -p 11112:11112 \
           -p 2575:2575 \
           -v /var/local/dcm4chee-arc/storage:/storage \
           -v /var/local/dcm4chee-arc/log:/opt/wildfly/standalone/log \
           -v /tmp:/opt/wildfly/standalone/tmp \
           --link slapd:ldap \
           --link postgres:db \
           -d dcm4che/dcm4chee-arc-psql:5.0.1-secure-ui

Use Docker Composite

Alternatively you may use Docker Composite to take care for starting and linking the 3 containers, by specifying the services in a configuration file docker-compose.yml (e.g.):

slapd:
  image: dcm4che/slapd-dcm4chee:5.0.1
  ports:
    - "389:389"
  environment:
    LDAP_BASE_DN: dc=dcm4che,dc=org
    LDAP_ORGANISATION: dcm4che.org
    LDAP_ROOTPASS: secret
    LDAP_CONFIGPASS: secret
    DEVICE_NAME: dcm4chee-arc
    AE_TITLE: DCM4CHEE
    DICOM_HOST: dockerhost
    DICOM_PORT: 11112
    HL7_PORT: 2575
    STORAGE_DIR: /storage/fs1
  volumes:
    - /var/local/dcm4chee-arc/ldap:/var/lib/ldap
    - /var/local/dcm4chee-arc/slapd.d:/etc/ldap/slapd.d
postgres:
  image: dcm4che/postgres-dcm4chee:5.0.1
  ports:
    - "5432:5432"
  environment:
    POSTGRES_DB: pacsdb
    POSTGRES_USER: pacs
    POSTGRES_PASSWORD: pacs
  volumes:
    - /var/local/dcm4chee-arc/db:/var/lib/postgresql/data
dcm4chee-arc:
  image: dcm4che/dcm4chee-arc-psql:5.0.1-secure-ui
  ports:
    - "8080:8080"
    - "9990:9990"
    - "11112:11112"
    - "2575:2575"
  links:
    - slapd:ldap
    - postgres:db
  volumes:
    - /var/local/dcm4chee-arc/storage:/storage
    - /var/local/dcm4chee-arc/log:/opt/wildfly/standalone/log
    - /tmp:/opt/wildfly/standalone/tmp

and starting them by

> $docker-compose up -d

Web Service URLs

• Archive UI: http://localhost:8080/dcm4chee-arc/ui - if secured, login with Username: user, Password: user.
• Keycloak Administration Console: http://localhost:8080/auth, login with Username: admin, Password: admin.
• Wildfly Administration Console: http://localhost:9990, login with Username: admin, Password: admin.
• DICOM WADO-URI: http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/wado
• DICOM QIDO-RS Base URL: http://localhost:8080/dcm4chee-arc/aets/DCM4CHEE/rs