Docker

Running locally

HiGlass can also be run locally as a docker container. The [higlass-docker](https://github.com/hms-dbmi/higlass-docker) repository contains detailed information about how to set it up and run it.

The simple example below stops any running higlass containers, removes them, pulls the latest version and runs it.

docker stop higlass-container;
docker rm higlass-container;

docker pull gehlenborglab/higlass:v0.4.17 # higher versions are experimental and may or may not work


docker run --detach \
           --publish 8989:80 \
           --volume ~/hg-data:/data \
           --volume ~/tmp:/tmp \
           --name higlass-container \
         gehlenborglab/higlass:v0.4.17

The higlass website should now be visible at http://localhost:8989. Take a look at the documentation for adding a new track to see how to display data.

Running remotely

For security reasons, an instance created this way will not be accessible from hosts other than “localhost”. To make it accessible to other hosts, please specify a hostname using the SITE_URL environment variable:

docker run --detach \
         --publish 8989:80 \
         --volume ~/hg-data:/data \
         --volume ~/tmp:/tmp \
         --name higlass-container \
         -e SITE_URL=my.higlass.org \
         gehlenborglab/higlass:v0.4.17

To use the admin interface for managing the available datasets, a superuser needs to created:

docker exec -it higlass-container higlass-server/manage.py createsuperuser

Once a username and password are created, the admin interface can be accessed at http://localhost:8989/admin.