1 Introduction

This protocol explains how to create an RSAT Docker image.

It is primarily inteded for RSAT development team, but can also be of use for advanced users who might desire to create a customized Docker image.

2 Requirement

  • A computer with an operating system supporting Docker (Linux, Mac OSX or Winodows >= 10).
  • A sufficient disk space (3Gb for the RSAT-docker image + 3Gb for the temporary container + some space for the RSAT local disk).

3 Configuration

3.1 Max OSX: Virtualbox network configuration

4 Protocol

  1. Start a Docker daemon

The way to start a Docker daemon depends on the host operating system. See the documentation on Docker Web site for more details.

For Mac OSX, a docker daemon can be started with the following command.

open /Applications/Docker/Docker\ Quickstart\ Terminal.app
Operating System Starting instructions
Mac OSX Docker https://docs.docker.com/docker-for-mac/docker-toolbox/
Mac OSX Docker toolbox https://docs.docker.com/docker-for-mac/

All the next steps are assumed to run under a Unix terminal with an active docker daemon.

  1. Download and clone a Debian image
docker pull debian:jessie
docker tag debian:jessie rsat_debian:2016-07-12.prepa
  1. Creating the shared space on the local machine
mkdir -p ~/rsat_docker/install
  1. Downloading the installation scripts.
cd ~/rsat_docker/install
wget --no-clobber http://teaching.rsat.eu/tutorials/DockerRSAT/scripts/RSAT_debian_install.sh
  1. vmatch licence

The sequence-purge tool requires a user-specific license for vmatch, a software tool developed by Stefan Kurtz. After having received this license, install the vmatch.lic in the folder ~/rsat_docker/install. This should be done manually.