Setup with Docker

Containers for the Mock Event Generator are stored in the Gitlab Container Registry. To access it, a Personal Access Token (with at least the read_registry scope) is required. To login:

echo <access-token> | docker login containers.ligo.org -u <token-name> --password-stdin

Upon successful login, the latest Docker image can be run. It contains a pre-loaded mock super-event from GraceDB playground. By creating a docker volume for the Mock Event Generator cache, downloaded events can be persisted. Autentication should be provide using SciTokens (One has to complete the authetication passing the provided link):

docker volume create meg-cache
docker run --pull always -it --rm --name meg-container \
    -v meg-cache:/home/meguser/.cache/mock-event-generator \
    containers.ligo.org/emfollow/mock-event-generator:latest bash
meguser@3e1c900a250c:~$ htgettoken -a vault.ligo.org -i igwn

Commands in the docker image can then be issued:

meguser@f8e5602cb5d7:~$ meg cache list
Cache: /home/meguser/.cache/mock-event-generator
├── S220609hl        source: playground
│   ├── G587369      CWB         Burst        BBH          ( 200) 1338848303.787 FAR=      0
│   ├── G587368      CWB         Burst        AllSky       ( 190) 1338848303.786 FAR=      0
│   ├── G587364      gstlal      CBC          AllSky       (  10) 1338848303.814 FAR=      0
│   ├── G587366      MBTAOnline  CBC          AllSky       (  43) 1338848303.869 FAR=      0
│   ├── G587367      CWB         Burst        BBH          ( 145) 1338848303.787 FAR=      0
│   └── G587365      gstlal      CBC          AllSky       (  15) 1338848303.809 FAR=      0
or
meguser@3e1c900a250c:~$ meg fetch --source production E394410
2026-04-21 07:44:26 INFO     Downloading E394410 from GraceDB (production)...