Add track hubs

Track hubs allow for the display of tracks of data alongside the other data in the Ensembl genome browser. This is a very flexible feature and the data can be hosted anywhere.
The following is an annotated example of an RNA-seq alignment track hub on the Heliconius melpomene melpomene Hmel2 assembly available on, which you can adapt to suit your data. Trackhubs are not visible by default but can be displayed by using the cog symbol to configure lowest of the region views on the linked page.

Set up the track hub

Add the track data to a publicly accessible location:
$ ls -sh /path/to/trackhub/data/rnaseq/heliconius_melpomene_melpomene_hmel2/
total 2.3G
98M 103M 101M 81M
111M 104M 81M 163M
105M 104M 75M 129M
110M 96M 108M 211M
105M 111M 100M 212M
Create a hub.txt file with a description of the data available in the track hub:
$ nano /path/to/trackhub/rnaseq/hub.txt
hub LepBase-RNASeq
shortLabel RNA-Seq Alignments
longLabel RNA-Seq Alignments for LepBase
genomesFile genomes.txt
Create a genomes.txt file with a 2 line entry for each assembly linking the assembly name to the associated track configuration files:
$ nano /path/to/trackhub/rnaseq/genomes.txt
genome Hmel2
trackDb Hmel2/trackDb.txt
Create a trackDb.txt file for your assembly:
  • the first section creates a superTrack to group all datasets
  • the following sections define three compositeTracks, one for each of the datasets included in the track hub
  • the remaining sections each specify the path to one of the bigwig files hosted on and the compositeTrack to which the sample belongs
$ nano /path/to/trackhub/rnaseq/Hmel2/trackDb.txt
track RNASeq
superTrack on
group RNASeq
shortLabel RNASeq
longLabel Heliconius melpomene melpomene tissues
html doc/RNASeq
track WingRNASeq
compositeTrack on
group WingRNASeq
shortLabel Wing RNA-Seq
longLabel Heliconius melpomene melpomene wing tissues
html doc/WingRNASeq
track PRJEB1499
compositeTrack on
group PRJEB1499
shortLabel PRJEB1499
longLabel RNA-seq of adult Heliconius melpomene rosina male and female chemosensory tissues: antennae, labial palps and proboscis, and legs
html doc/PRJEB1499
track PRJNA283415
compositeTrack on
group PRJNA283415
shortLabel PRJNA283415
longLabel Sex-specific transcriptomes of adult head and abdomen from 3 species of Heliconius butterfly
html doc/PRJNA283415
track ERR232445
parent PRJEB1499
type bigWig
shortLabel ERR232445
longLabel Hmel_503_F_labial_palps_proboscis
color 204,0,0
html docs/ERR232445
visibility full
track SRR2076766
parent PRJNA283415
type bigWig
shortLabel SRR2076766
longLabel R29_F_mel_ab
color 204,0,0
html docs/SRR2076766
visibility full
track 13F
parent WingRNASeq
type bigWig
shortLabel 13F
longLabel 13F
color 204,0,0
html docs/13F
visibility full
For each sample, add an html file with a brief description to a docs folder:
  • this will be displayed if a user clicks the information icon while configuring the display in the Ensembl browser to show/hide tracks
$ nano /path/to/trackhub/rnaseq/Hmel2/docs/ERR232445.html
Heliconius melpomene transcriptome sample Hmel_503_F_labial_palps_proboscis (SRA accession: <a href="">ERR232445</a>)

Add the track hub to your Ensembl browser

Add/edit an assembl-specific configuration file in your Ensembl plugin:
  • update the url to point to your own site
  • remember to commit and push the changes when done
$ nano conf/ini-files/Heliconius_melpomene_melpomene_hmel2.ini
RNASEQ = genomehubs_rnaseq
source_name = genomehubs_rnaseq
url =
Restart your Ensembl site to add the track hub:
  • adding the trackhub to an assembly requires a restart, but subsequent changes to the data/configuration files will be picked up automatically
$ docker rm -f genomehubs-ensembl
$ docker run -d \
--name genomehubs-ensembl \
-v ~/genomehubs/v1/ensembl/conf:/ensembl/conf:ro \
--link genomehubs-mysql \
-p 8081:8080 \
$ docker rm -f genomehubs-ensembl
$ docker run -d \
--name genomehubs-ensembl \
-v ~/genomehubs/v1/ensembl/conf:/conf:ro \
--link genomehubs-mysql \
-p 8081:8080 \