The Search Tag & Analyze Resource for collaborative annotation and interpretation of disease from open digital samples from GEO.

Here are steps to make local deployment of this app in order to tinker it.

1. Get sources:

   git clone git@github.com:idrdex/star-django.git
   cd star-django

2. Install dependencies:

   We will use virtualenv and virtualenvwrapper to create isolated python environment, so start with:

   sudo pip install virtualenv virtualenvwrapper

   When create a virtualenv for our project and install dependencies:

   mkvirtualenv star
   pip install -r requirements-dev.txt
   

3. Update settings:

   All settings that should vary by deployment go to .env file, so:

   cp .env.example .env
   <edit> .env

   Adjust settings in .env file, you will probably need to only set DATABASE_URL for your working copy.

4. Create or migrate database tables:

   ./manage.py migrate
   ./manage.py createsuperuser

5. Run it and have fun:

   ./manage.py runserver 5000

   Go to http://localhost:5000/ to see the app or to http://localhost:5000/admin/ to see admin panel.

   To debug background tasks you'll need to start celery:

   honcho start celery

   NOTE: it doesn't autorestart, you'll need to do that manually.

   To run both development web-server and celery in single terminal and autorestart both do:

   # .. install node.js and npm somehow
   npm install -g nodemon
   
   nodemon -x 'honcho start' -e py

1. Configure ssh connection by adding something like this to ~/.ssh/config:

   Host stargeo
   HostName ec2-52-11-148-105.us-west-2.compute.amazonaws.com
   User ubuntu
   IdentityFile /path/to/stargeo.pem
   IdentitiesOnly yes

2. Run locally:

   # to deploy latest commited
   fab deploy
   
   # to deploy whatever you have locally (not recommended)
   fab dirty_deploy