ExploSig Docker Configuration

Please visit the wiki for information about customizing this configuration.

Setup

To run ExploSig and ExploSig Server locally using docker:

Install Docker and Docker Compose:

Docker for Mac or for Windows
Docker Compose (should come bundled with Docker)

Clone this repository

git clone https://github.com/lrgr/explosig-docker.git

Enter into this repository

cd explosig-docker

The data directory

Notice the obj folder within explosig-docker. This is where ExploSig Server will look for data. Run pwd in this directory and make note of the absolute path.

The metadata files in the obj directory can be updated to specify custom signatures and/or mutation datasets. Please see the wiki for detailed information about file formats.

The database directory

Run the following command to create a mysql folder within explosig-docker:

mkdir mysql

This is where ExploSig Server will store the database used for saving/sharing ExploSig sessions and history. Run pwd in this directory and make note of the absolute path.

The docker-compose file

Notice the docker-compose.yml file within explosig-docker.

Update this file:

Change the backend volumes path to the absolute path of your obj directory
Change the db volumes path to the absolute path of your mysql directory

version: '2'
services:
  explosig:
    ...
  explosig_server:
    ...
    volumes:
    - /path/to/your/obj:/obj                     <--------- UPDATE
  db:
    ...
    volumes:
    - /path/to/your/mysql:/var/lib/mysql         <--------- UPDATE

Pull

Pull down the two docker containers specified in the docker-compose file

docker-compose pull

Running

Up

Run the two docker containers

docker-compose up

Up - daemonized

Run the two docker containers in the background

docker-compose up -d

Up - development

Run the development containers (code as mounted volumes).

export EXPLOSIG_DEV_PATH=$(pwd)/../
docker-compose -f dev.docker-compose.yml up