View on GitHub

OpenGenomeBrowser

OpenGenomeBrowser is a dynamic and scalable web platform for comparative genomics.

Installation

Get OpenGenomeBrowser running in 10 minutes!

These are the basic steps:

  1. Clone OpenGenomeBrowser docker template
  2. Download demo database
  3. Run docker-compose
  4. Connect to the OpenGenomeBrowser container
  5. Create superuser
  6. Load the folder structure into the database

In order to run OpenGenomeBrowser with your own data you will have to prepare your files as described below.

Prerequisites

Note: ensure you have a current version of docker! System repositories tend to be out of date!

Clone the OpenGenomeBrowser docker template

git clone https://github.com/opengenomebrowser/opengenomebrowser-docker-template.git
cd opengenomebrowser-docker-template

Download demo database

./download_demo_db.sh

... or use your own database, of course! Read the documentation on how to do that.

Run docker-compose

docker-compose -f production-template.yaml up

Open https://localhost/, ignore the self-signed certificate, and you should see the welcome page!

Connect to the OpenGenomeBrowser container

In a seperate terminal, run:

# open terminal in docker-container
docker exec -ti opengenomebrowser_web bash

# log in as user
$docker (root)# sudo -u user --preserve-env bash

Create superuser

In the terminal from before, run:

# create django administrator account
$docker (user)# python manage.py createsuperuser

Open https://localhost/admin/ and you should be able to log in with your superuser account. Here, you could create new regular users.

Load the folder structure into the database

In the terminal from before, run:

# import organisms and genomes
$docker (user)# python db_setup/manage_ogb.py import-database

# import ortholog annotations
$docker (user)# python db_setup/manage_ogb.py import-orthologs

# import pathway maps
$docker (user)# python db_setup/manage_ogb.py import-pathway-maps

Congratulations, OpenGenomeBrowser is ready! (Example: https://localhost/pathway/?map=kornec00400&g1=@tax:root)

Get ready for production

Apply updates

Updates are very simple to install. Simply stop the running container, pull the latest

# stop OpenGenomeBrowser (Ctrl+C)
# pull newest image
docker pull opengenomebrowser/opengenomebrowser
# start OpenGenomeBrowser
docker-compose -f production-template.yaml up

From time to time, something like the following message may appear:

The folder structure needs to be updated to match OpenGenomeBrowser code.
Current version: 1, expected: 2
Use the script update_folder_structure from the package opengenomebrowser_tools to perform the upgrade!

It means that the folder structure requires certain changes to be compatible with the new version of OpenGenomeBrowser. These changes can be applied using the function update_folder_structure in opengenomebrowser-tools.