ImmuneDB
v0.29.4

Getting Started

  • Introduction
  • Installing with Docker (recommended)
    • Pulling the Docker Image
    • Running the Container
      • Next Steps
  • Installing Locally (advanced)

Running the Pipeline

  • Running the Example Pipeline
  • Running the Pipeline on Your Data

Querying an Existing Database

  • Python API
  • Directly Querying the Database

Other

  • Referencing ImmuneDB
  • Related Publications & Software
ImmuneDB
  • Docs »
  • Installing with Docker (recommended)
  • Edit on GitHub

Installing with Docker (recommended)¶

Pulling the Docker Image¶

With Docker installed the following command to get the newest version of the ImmuneDB Docker image:

$ docker pull arosenfeld/immunedb:v0.29.4

Running the Container¶

To start a shell session within the container run:

$ docker run -v $HOME/immunedb_share:/share \
    -p 8080:8080 -it arosenfeld/immunedb:v0.29.4

This will start a shell with ImmuneDB and accessory scripts pre-installed as well as create a shared directory between the host and Docker container. Files placed in the host’s $HOME/immunedb_share directory and it will appear in /share within the Docker container (and vice versa). Note $HOME on macOS is generally /Users/your_username/ and on Linux it is generally /home/your_username.

Additionally, MySQL stores its data in /share/mysql_data so databases will persist across multiple container invocations.

The location of important files are:

  • /root/germlines: IMGT aligned germlines for IGH, TCRA, and TCRB.
  • /apps/bowtie2/bowtie2: The local-alignment tool Bowtie2. This file is in the container’s $PATH.
  • /share/configs: The recommended directory to store ImmuneDB configurations generated by immunedb_admin create.
  • /share/mysql_data: The location MySQL (specifically MariaDB) will store its data.
  • /example: A set of example input data to familiarize yourself with ImmuneDB

Next Steps¶

Once the Docker container is running, you should continue by testing out the example pipeline.

Next Previous

© Copyright 2018, Drexel University Systems Immunology Lab Revision 290c6343.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: v0.29.4
Versions
latest
stable
v0.29.5
v0.29.4
v0.29.3
v0.29.2
v0.29.1
v0.29.0
v0.28.1
v0.28.0
v0.27.0
v0.26.0
v0.25.1
v0.25.0
develop
Downloads
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.