Docker Image

What is Docker?

Think of a Docker container as a minimal virtual machine that runs only the processes that are needed for a given application, here POPScomp. The advantage of using Docker is that you can run the software on your own computer without having to go through a multi-step installation procedure. It suffices to download and run the Docker image.

Prerequisites

You need to have Docker installed on your computer.

Downloading the POPScomp Docker image

You can now pull the POPScomp image from the Docker Hub (https://hub.docker.com/repository/docker/jkleinj150999/popscomp/) to your computer. The image tag (here 'newest') might vary between releases, please use the one referenced on Docker Hub.

docker pull jkleinj150999/popscomp:latest

List local Docker images

docker images
## REPOSITORY               TAG      IMAGE ID       CREATED         SIZE
## jkleinj150999/popscomp   latest   43fb4b2e1970   6 minutes ago   2.83GB

Initialise the POPScomp Docker container

The simplest way to start a container from the image is:

docker run -p 3838:3838 popscomp

On a Mac the equivalent comand is:

docker run --platform linux/amd64 -p 3838:3838 popscomp

Accessing the POPScomp Shiny App

Open a Web browser and enter the following URL address:

http://localhost:3838/

That opens the POPScomp App in your browser. Documentation about the method, App usage and output data can be found in the App and this Wiki.

Note about underlying Shiny Docker Image

The POPScomp software is grafted onto the rocker/shiny image.

https://hub.docker.com/r/rocker/shiny

The full installation sequence is prescribed in the Dockerfile.