histolab box

histolab ready-to-use (batteries included) through Docker

This repo contains a complete histolab environment that can be used through Docker. It inludes all the dependecies as well as jupyter notebook server with a complete example notebook.

Installation and Usage

Download and install docker according to your operating system

• https://docs.docker.com/docker-for-mac/install/
• https://docs.docker.com/engine/install/ubuntu/
• https://docs.docker.com/docker-for-windows/install/

Check your installation

Mac OSX and Linux

Open a command-line terminal, and try out some Docker commands.

Run docker version to check that you have the latest release installed.

Run docker run hello-world to verify that Docker is pulling images and running as expected.

Windows

Open a command-line terminal like PowerShell, and try out some Docker commands!

Run docker version to check the version.

Run docker run hello-world to verify that Docker can pull and run images.

Run histolab-box

Once docker is up and running on your machine, you need to pull the official histolab-box docker image from dockerhub using the command:

docker pull histolab/histolab-box

Once the images has been pulled from dockerhub:

docker run -p 8888:8888 histolab/histolab-box

Open the jupyter notebook at the address you can see in the shell output:

e.g. http://127.0.0.1:8888/?token=3b48d331ef94f1862108836416dd11a4b29d6f0738166d0a