commented in compose.yml

Author: Jing Liu

compose.yml

@@ -1,33 +1,39 @@
 services:
-  # no X11 mapping is included as it is hard for a beginner to set up an X11 server
   geant4: # docker compose run --service-ports geant4
-    image: physino/geant4
-    platform: linux/amd64
-    command: /usr/bin/bash
-    volumes: [ .:/root/geant4 ]
-    # ports are only exposed by compose up, not compose run
-    # --service-ports is needed for compose run to expose ports
+    image: physino/geant4 # minimalistic container image + cmd-line tools
+    platform: linux/amd64 # pre-compiled geant4 is not available for arm64
+    command: /usr/bin/bash # `docker compose up` quits immediately
+    volumes: # no X11 setup is included to be beginner friendly
+      - .:/root/geant4 # load current folder as /root/geant4 in container
+    # ports are only exposed by `compose up`, not `compose run`
+    # --service-ports is needed for `compose run` to expose ports
     ports: [ 8888:8888, 8889:8889 ]
+    # feel free to change the timezone identifier below according to
+    # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
     environment: [ TZ=US/Central ]
     hostname: AlmaLinux
-    build: container
-  g4:
-    image: physino/geant4:11.2.1
-    platform: linux/amd64 # pre-compiled geant4 is not available for arm64
-    profiles: [ "g4" ] # avoid running it by `compose up`
+    container_name: physino-geant4
+    build: container # for container developers
+  g4: # docker compose run --rm g4
+    image: physino/geant4:11.2.1 # minimalistic container image
+    platform: linux/amd64
+    profiles: [ "g4" ] # avoid running it by `docker compose up`
     command: /usr/bin/bash
     volumes: [ .:/root/geant4 ]
     # https://unix.stackexchange.com/a/698068/26929
     # https://stackoverflow.com/a/63291253/1801749
     environment: [ TZ=US/Central ]
     hostname: AlmaLinux # https://stackoverflow.com/a/63291253/1801749
-    build: 11.2.1
+    build: 11.2.1 # docker compose build g4
   heprapp: # docker compose run --rm heprapp
     command: /usr/bin/hv # launch HepRApp
     image: physino/heprapp # https://hub.docker.com/r/physino/heprapp
     profiles: [ "heprapp" ]
     environment:
       - DISPLAY=host.docker.internal:0.0
+    # host.docker.internal doesn't exist in a Linux host
+    # https://stackoverflow.com/a/24326540
+    # https://stackoverflow.com/questions/70725881
     extra_hosts:
       - "host.docker.internal:host-gateway"
     volumes: