Skip to content
Genomics England PanelApp - A crowdsourcing tool to allow gene panels to be shared, downloaded, viewed and evaluated by the Scientific Community
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


The Panel App is a crowd-sourced repository of information about various Gene panels.


pip install -e . will install the application


For development, you can use docker-compose. This will take care of all services and databases locally.

docker-compose up
docker-compose run web python3 /app/panelapp/ migrate
docker-compose run web python3 /app/panelapp/ collectstatic --noinput
docker-compose run web python3 /app/panelapp/ createsuperuser

You can also use docker to deploy the application.


The Panel App is a project based on Django Framework (v2.1) with PostgreSQL as a backend.

Python version: 3.5

Python dependencies are installed via


docker-compose up

The command above should start all services and Django locally with DEBUG=True so you can use it for the development.

To setup the database schema please run migrate command

docker-compose run web python3 /app/panelapp/ migrate

If you need to debug a model use shell_plus extension, you can access it via python shell_plus. This will load all available models and Django settings.

docker-compose run web python3 /app/panelapp/ shell_plus

If you want to access admin panel you can either register on the website, and then change permissions via shell_plus or use python createsuperuser command.

docker-compose run web python3 /app/panelapp/ createsuperuser

We also run Celery with RabbitMQ backend for async tasks. To run celery simply run celery -A panelapp worker. It should start automatically with docker compose.

Gene data

In order to add genes to panels, you need to load gene data. Uncompress deploy/genes.tgz, copy it to panelapp folder and run: docker-compose run web python3 /app/panelapp/ loaddata /app/panelapp/genes.json.

Genes data contains public gene info, such as ensembl IDs, HGNC symbols, OMIM ID.

Project configuration

The project can live in any location on disk, however it requires two writable locations: one for static files, the other for uploads.

The location for these two directories in configures in panelapp/settings/<environment>.py file

Run /path/to/ve/bin/python /path/to/app/panelapp/ collectstatic --noinput for pulling all statics inside the _staticfiles folder


docker-compose run web pytest

Environment Variables

App Secrets

  • SECRET_KEY - used to encrypt cookies
  • DATABASE_URL - PostgreSQL config url in the following format: postgresql://username:password@host:port/database_name
  • CELERY_BROKER_URL - Celery config for RabbitMQ, in the following format: amqp://username:password@host:port/virtual
  • HEALTH_CHECK_TOKEN - URL token for authorizing status checks
  • ALLOWED_HOSTS - whitelisted hostnames, if user tries to access website which isn't here Django will throw 500 error
  • DJANGO_ADMIN_URL - change admin URL to something secure.

Other variables

  • DEFAULT_FROM_EMAIL - we send emails as this address
  • PANEL_APP_EMAIL - PanelApp email address
  • DJANGO_LOG_LEVEL - by default set to INFO, other options: DEBUG, ERROR
  • STATIC_ROOT - location for static files which are collected with python collectstatic --noinput
  • MEDIA_ROOT - location for user uploaded files
  • EMAIL_HOST - SMTP host
  • EMAIL_HOST_USER - SMTP username
  • EMAIL_PORT - SMTP server port
  • EMAIL_USE_TLS - Set to True (default) if SMTP server uses TLS

Contributing to PanelApp

All contributions are under Apache2 license.

You can’t perform that action at this time.