Sign up for one account at Docker Hub:

https://hub.docker.com/signup

For windows and mac users, download and install the Docker Desktop here:

https://www.docker.com/products/docker-desktop

After installed the Docker Desktop, docker will log off automatically and ask you to switch on the Hyper-V.

Then restart the computer to have the Docker Desktop running correctly.

For linux users install Docker follow the instructions here:

https://docs.docker.com/install/

Note: you need to have administrator access on your computer to install docker.

Open a terminal or command window, for Windows, open the PowerShell, and pull the image of MercuryTrunk by running this command:

"sudo docker pull haoutwente/mercurytrunk"

Check that "MercuryTrunk" is in the list of images you have, using this command:

"sudo docker images"

For Mac user, to setup visualization environment:

• Install the latest XQuartz X11 server and run it: https://www.xquartz.org/
• Activate the option ‘Allow connections from network clients’ in XQuartz Preferences -> Security tab
• Quit and restart XQuartz to activate the setting.
• Ensure localhost is allowed X11 forwarding by running this command line: "xhost + 127.0.0.1"
• Then run this in command line: "sudo docker run -it -e DISPLAY=host.docker.internal:0 haoutwente/mercurytrunk"

For Linux user, to setup visualization environment run these in command line:

• sudo apt install libx11-dev libxt-dev libxres-dev libxtst-dev 
• Then run this in the command line: "xhost +"
• Then run the following to open the image

       "sudo docker run -it -v /etc/localtime:/etc/localtime:ro -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=unix$DISPLAY -e GDK_SCALE -e GDK_DPI_SCALE haoutwente/mercurytrunk"

For Windows user, to setup visualization environment:

• Install the latest XMing and run it: https://sourceforge.net/projects/xming/files/latest/download
• Then run this in PowerShell: "docker run -it -e DISPLAY=host.docker.internal:0 haoutwente/mercurytrunk"

The following is for us to maintain the image to be always newest (Another option will be build up the essentials using Dockerfile and then add line by line the commands to build up the image from basic Ubuntu.

This might avoid update the source image every now and then, but for our update frequency it might not worth it anyway.)

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

To save changes of the current image:

"sudo docker commit -m "MESSAGE" -a "AUTHOR_INFO" CONTAINER_ID haoutwente/mercurytrunk:latest

Then push it back to the docker hub:

"sudo docker push haoutwente/mercurytrunk"