This example contains a Dockerfile which includes two research tools and a sample notebook:
- Jupyter notebook container pulled from source.
- blastn bioinformatics tool (installed during the container build via
apt-get...
) - Jupyter notebook blastn example based on the blastn tutorial from source.
A. To start an instance using the pre-built container image on DockerHub
- Verify the image on DockerHub
- Get a local copy of the image from Docker Hub by running
docker pull lynnlangit/blastn-jupyter-docker
- Start an instance of the image by running
docker run -p 8888:8888 lynnlangit/blastn-jupyter-docker
- Connect to the example Jupyter notebook in your browser using the link generated
- Navigate and run the jupyter notebook located in /work/
B. To build a Dockerfile from image source files (on GitHub):
- Clone the source repo
- Build the image by running
docker build -t blastn-jupyter-docker .
- Wait for the build to complete (takes ~15 minutes)
- Start an instance of the image by running
docker run -p 8888:8888 blastn-jupyter-docker
- Connect to the example Jupyter notebook in your browser using the link generated
- Navigate and run the jupyter notebook located in /work/
TIP: If your browser returns a 'connection_refused' error, when you attempt to connect using
the generate URL (such as http://0.0.0.0:8888/?token=87ea7335fd396f88fa945aa7dd871fe9de49767a3f626875
,
then determine the mapped IP (such as 192.168.10.100), connect using that IP:port (such as http://192.168.10.100:8888
and then copy the token value from the generated URL and paste it into the token text box in the browser.