Setup

This document will review basic setup of the sendit application. You will need root (sudo) permissions on a server, and ideally the ability to serve a web application (via a Docker image). The application can run without the web interface, but it’s a nice way to interact and view what is going on.

Download

Before you start, you should make sure that you have Docker and docker-compose installed, and a complete script for setting up the dependencies for any instance is provided. We basically install docker-compose, docker, and download this repository to an install base.

You should walk through this carefully to make sure everything completes, and importantly, to install docker you will need to log in and out. The last steps in the preparation are to clone the repo, and we recommend a location like /opt.

cd /opt
git clone https://www.github.com/pydicom/sendit
cd sendit

This will mean your application base is located at /opt/sendit and we recommend that your data folder (where your system process will add files) be maintained at /opt/sendit/data. You don’t have to do this, but if you don’t, you need to change the folder in the docker-compose.yml to where you want it to be. For example, right now we map data in the application’s directory to /data in the container, and it looks like this:

uwsgi:
  restart: always
  image: pydicom/sendit
  volumes:
    - ./data:/data

to change that to /tmp/dcm you would change that line to:

uwsgi:
  restart: always
  image: pydicom/sendit
  volumes:
    - /tmp/dcm:/data

You should next configure your application before building the image.