Doc.Installation.Docker.Linux.Full - JETSCAPE/JETSCAPE GitHub Wiki

The Docker image with JETSCAPE preinstalled is intended for users who would like to run JETSCAPE but do not intend to develop JETSCAPE.

Note that this Docker image is currently being tested, and is therefore tagged beta.

Instructions to run JETSCAPE using a Docker image with JETSCAPE preinstalled

It is assumed that Docker is already installed on your Linux or WSL (Windows Subsystem for Linux) system, and a Linux terminal is running.

Step 1: Pull the Docker Image

docker pull jetscape/jetscape_full:beta_v0.3

Step 2: Run a Container Based on the Image

docker run -it -v ~/:/home/host --name myJetscapeFull jetscape/jetscape_full:beta_v0.3

The above command creates a container based on image jetscape/jetscape_full:beta_v0.3. Your host system's home directory is mounted in the container at home/host. The container is given the name myJetscapeFull.

The command prompt will now indicate that you are inside the container. Typing the ls command will show only the JETSCAPE folder.

Step 3: cd to JETSCAPE's Build Folder

cd JETSCAPE/build

Step 4: Run JETSCAPE

./runJetscape ../config/publications_config/arXiv_1910.05481/jetscape_user_PP_1910.05481.xml

After JETSCAPE runs, .dat files will be written to your build folder.

Step 5: Access the Mounted Host System Directory

cd /home/host
ls

cd to the /home/host directory. You should see the files in your host system's home directory. You can copy files between this mounted directory of your host filesystem and the preinstalled JETSCAPE installation at /home/jetscape-user/JETSCAPE.

Step 6: Exit the Container

exit

Your usual host system command prompt should return.

Step 7: Restart the Container

docker start -ai myJetscapeFull

Because the container was already created on Step 2, it doesn't have to be created again. You may restart the container using the name given to it on step 2.