Install Docker

Linux

If you are on Linux, we highly recommend Singularity.

Install Docker by following these instructions: https://docs.docker.com/install/

Allow your user to run docker (requires admin privileges):

sudo groupadd docker
sudo usermod -aG docker $USER

Log out and log back in.

Then shell into Docker

docker run -it -v ~/jetscape-docker:/home/jetscape-user --name myJetscape --user $(id -u):$(id -g) jetscape/base:v1.4

OS X

Install Docker Desktop for Mac: https://docs.docker.com/docker-for-mac/install/

Open Docker, go to Preferences --> Advanced and:

1. Set CPUs to max that your computer has (sysctl -n hw.ncpu)
2. Set memory to what you are willing to give Docker

Then shell into Docker

docker run -it -v ~/jetscape-docker:/home/jetscape-user --name myJetscape jetscape/base:v1.4

Windows

Install Docker: https://docs.docker.com/docker-for-windows/install/

1. Double-click Docker Desktop Installer.exe to run the installer. If you haven’t already downloaded the installer (Docker Desktop Installer.exe), you can get it from Docker Hub. It typically downloads to your Downloads folder, or you can run it from the recent downloads bar at the bottom of your web browser.
2. When prompted, ensure the Enable Hyper-V Windows Features or the Install required Windows components for WSL 2 option is selected on the Configuration page.
3. Follow the instructions on the installation wizard to authorize the installer and proceed with the install. When the installation is successful, click Close to complete the installation process.
4. If your admin account is different to your user account, you must add the user to the docker-users group. Run Computer Management as an administrator and navigate to Local Users and Groups > Groups > docker-users. Right-click to add the user to the group. Log out and log back in for the changes to take effect.

Docker Desktop does not start automatically after installation. To start Docker Desktop, search for Docker, and select Docker Desktop in the search results.

When the initialization is complete, Docker Desktop launches the onboarding tutorial. The tutorial includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.

After installing Docker on your local machine, sign up for a Docker ID [https://hub.docker.com/signup]

Then shell into Docker

docker run -it -v ~/jetscape-docker:D:\jetscape-user --name myJetscape jetscape/base:v1.4

Running JETSCAPE (system-independent once a Docker shell is open)

Create a directory called "rhic_ags_school" and CD into it.

mkdir /rhic_ags_school
cd /rhic_ags_school

Clone JETSCAPE.

git clone https://github.com/TianyuDai/JETSCAPE-rhic-ags

CD into the cloned repository. Get external packages

cd JETSCAPE-rhic-ags
cd external_packages
bash get_music.sh 
cd ..

Create a directory called build. CD into the build directory and build JETSCAPE.

mkdir build
cd build
cmake -DUSE_MUSIC=ON ../
make -j