The next stage in the process is getting the required Docker images ( the prebuilt software that will be run as containers inside your computer). Downloading these will use approximately 3Gb of data and take up approximately 5Gb of space on your computer. It is ideal to have these downloaded in advance of the workshop to avoid delays or potential slow internet access at the time.

To get the required Docker images, we will use Git to retrieve the source code that specifies to Docker how to download them and configure them correctly.

The 3 software packages we will install and configure are LimeSurvey (Web based questionnaire design and data collection tool), queXF (tool for processing paper questionnaire forms), and queXS (tool for conducting telephone interviews).

Downloading ("pulling") LimeSurvey

First, open a command/terminal window. In Windows, do this by clicking on the start button, and typing in "cmd.exe". Please run that and a new window with a black background should appear.

In the command window, type or paste in the following, then press enter:

git clone https://github.com/adamzammit/limesurvey-docker

This will get the source code required to run LimeSurvey in a container.

Now the following will move us to the correct directory/folder

cd limesurvey-docker

Now get the demo branch

git checkout demo

Now to get the required images from Docker (pulling) please run:

docker compose pull

You should be presented with some status showing the various required images/layers being downloaded and then extracted.

Now please run:

cd ..

To return to your default directory.

Downloading ("pulling") queXF

You can use the same open command window to now get the required images for queXF. 

In the command window, type or paste in the following, then press enter:

git clone https://github.com/adamzammit/quexf-docker

This will get the source code required to run queXF in a container.

Now the following will move us to the correct directory/folder

cd quexf-docker

Now get the demo branch

git checkout demo

Now to get the required images from Docker (pulling) please run:

docker compose pull

You should be presented with some status showing the various required images/layers being downloaded and then extracted.

Now please run:

cd ..

To return to your default directory.

Downloading ("pulling") queXS

You can use the same open command window to now get the required images for queXS. 

In the command window, type or paste in the following, then press enter:

git clone https://github.com/adamzammit/quexs-docker

This will get the source code required to run queXS in a container.

Now the following will move us to the correct directory/folder

cd quexs-docker

Now a new step, we need to retrieve the code from a "branch". This is a similar but different set of code to the main queXS docker image, customised to work well for demonstration purposes.

git checkout demo2

Now to get the required images from Docker (pulling) please run:

docker compose pull

You should be presented with some status showing the various required images/layers being downloaded and then extracted.

Now please run:

cd ..

To return to your default directory, or you can now close your command/terminal window.

Last modified: Monday, 5 August 2024, 2:54 PM