The Refinery Platform is a data management, analysis and visualization system for bioinformatics and computational biology applications. The platforms consists of three major components: a data repository with rich metadata capabilities, a workflow engine based on the popular Galaxy system, and visualization tools to support the exploration and …
jkmarx Jkmarx/add twitter component (#3138)
* Add buttons.

* Add video and twitter settings.

* Shorten default intro paragraph.

* Twitter component.

* Add unit tests.

* Adjust padding.

* Typo.
Latest commit 9b4e40d Dec 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update Sep 19, 2016
deployment Jkmarx/add twitter settings (#3137) Dec 12, 2018
docs Add files via upload Dec 20, 2017
media Remove unnecessary blank lines Aug 4, 2015
refinery Jkmarx/add twitter component (#3138) Dec 12, 2018
.flake8 Centralize flake8 config for consistency and easy updates (#2568) Feb 7, 2018
.gitignore Remove data_set_manager test data zip files from .gitignore (#2395) Nov 28, 2017
.landscape.yml Mccalluc/errors from landscape (#1933) Jul 24, 2017
.pre-commit-config.yaml Remove isort. (#2734) Apr 27, 2018
.travis.yml Scottx611x/postgresql upgrade (#3068) Nov 2, 2018
AUTHORS Test Travis-CI Jan 6, 2017 Merge branch 'release-1.6.7' Nov 13, 2018 Add (#1807) Jun 19, 2017
LICENSE Update license. (#1612) Feb 10, 2017 Mccalluc/dev docs (#2368) Nov 14, 2017 Move jq info to the wiki Nov 8, 2018
Vagrantfile Fix #2795 (#2801) Jun 1, 2018 Rsync needs to run as a superuser to preserve ownership. Check if the… Mar 8, 2016 Hackdna/update fabfile (#2648) Mar 9, 2018
fabricrc.sample Add test host config to Fabric Aug 5, 2016
requirements-aws.txt Hackdna/s3 upload dataset integration (#1997) Aug 17, 2017
requirements.txt Mccalluc/lru tool management 0.1.2 (#3034) Sep 28, 2018 Added missing `$NOW`. Mar 9, 2016
version.txt Bump version to 1.6.7 Nov 5, 2018

 Refinery Platform

Build Status Code Health Coverage Status

  • Additional information about how to administer and develop Refinery can be found in the wiki
  • Production deployments require access to Amazon Web Services
  • Refinery supports the latest version of Chrome (Linux and OS X), Firefox (Linux and OS X), and Safari (OS X)

Installing and Launching for Development


Configure and Load Virtual Machine

$ git clone
$ cd refinery-platform
$ vagrant up

The above step should take about 15 minutes depending on the speed of your machine and Internet connection. If you get an error, simply retry by:

$ vagrant provision

Open in your web browser.

Configure Deployment Environment on the Host

Create a Python 2.7 virtual environment (optional but recommended, assumes virtualenvwrapper is installed):

$ mkvirtualenv -a $(pwd) refinery-deployment

Install deployment tools (assumes header files for Python are installed):

$ pip install -r deployment/requirements.txt

Install Pre-Commit Hooks

Use fabricrc.sample to update or initialize Fabric configuration, for example:

$ cp fabricrc.sample ~/.fabricrc

To pull the latest code and update Refinery installation:

$ fab vm update

Refinery Operations on the VM

Connect to the initialized VM:

$ vagrant ssh
$ workon refinery-platform
$ ./ [command]

Log in to Refinery ( with the default guest user account (username: guest, password: guest).

Log in to Django admin UI ( with the default superuser account (username: admin, password: refinery).

Please see installation notes for more details, including information on how to configure Galaxy for this setup.


  • Refinery deployment requires a lot of external dependencies. You might have to run vagrant provision repeatedly to install all dependencies successfully. Any errors in the output of vagrant provision indicate that you have to re-run the command.
  • If you run into a build error in OS X when trying to install Fabric: export C_INCLUDE_PATH=/usr/local/include
  • If you have a VPN connection running, you may need to disconnect and reconnect before you can access the VM. In some cases you may have to reboot the host machine.
  • To make sure all the required services are running after the VM was restarted or shut down, you need to provision again: vagrant reload --provision or vagrant up --provision