Skip to content

Commit ea05041

Browse files
schwicketiborsimko
authored andcommitted
feat(docs): adapt documentation for DELPHI containers to latest version
1 parent b0c24a5 commit ea05041

File tree

1 file changed

+21
-1
lines changed

1 file changed

+21
-1
lines changed

data/docs/delphi-guide-docker/delphi-guide-docker.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,11 @@ The image is configured with a local user called `delphi`. For the commands belo
1919
* a prompt `$ xyz` indicates that the command `xyz` is to be run on your local machine or VM.
2020
* a prompt `[delphi ~] $ xyz` indicates that the command `xyz` is to be run inside the started container.
2121

22+
The Alma9 images come with support for `EOS`: when launched on a system which supports fuse file systems, the DELPHI data will be available inside the container beneath the path `/eos/opendata/delphi`. In addition, they support reading data over the network using the xrootd protocol.
23+
24+
Be aware that due to the --rm option, the container will be destroyed when you exit it, and all the work done inside the container will be lost.
25+
26+
### On a Linux based system
2227
To start the container on a Linux based system, use:
2328

2429
```
@@ -28,7 +33,22 @@ $ docker run --privileged --rm -it -e DISPLAY --network host -v /tmp/.X11-unix:/
2833

2934
This command will download the Alma9 based container and create a login shell for the DELPHI user.
3035

31-
This image comes with support for `EOS`: when launched on a system which supports fuse file systems, the DELPHI data will be available inside the container beneath the path `/eos/opendata/delphi`. Note that due to the --rm option, the container will be destroyed when you exit it, and all the work done inside the container will be lost.
36+
### On MacOS
37+
On recent Macs with M1, M2 or M3 CPUs it is better to use the ARM64 image, to avoid issues when linking executables inside the container. Also, if you are running MacOS, the command to start the container is a bit different.
38+
39+
```
40+
podman run --privileged -it -e DISPLAY=host.docker.internal:0 --network host -v /tmp/.X11-unix:/tmp/.X11-unix -v ~/.Xauthority:/home/delphi/.Xauthority --user delphi gitlab-registry.cern.ch/delphi/deployment/delphi/al9_aarch64 /bin/bash -l
41+
```
42+
43+
Also, the X server settings must allow connections from external sources. In addition, you may have to set
44+
```
45+
export LIBGL_ALWAYS_INDIRECT=1
46+
```
47+
in the container shell if you plan to run the event display.
48+
49+
### On Windows
50+
Running the container images on Windows has not been tested. Feedback is welcome.
51+
3252

3353
<p><center><img src="/static/docs/delphi-guide-docker/delphi-container-start.png" width="60%"></center></p>
3454

0 commit comments

Comments
 (0)