Globus Personal Connect Docker

Run Globus Connect Personal in a Docker container.

Setup

The latest container can be pulled from github:

docker pull ghcr.io/swissopenem/globusconnectpersonal:main

Alternately, you can build locally:

docker build -t globuspersonalconnect .

Setup works best using a GCP Setup Key

1. Navigate to the Globus WebApp GCP Setup Key page.
2. Generate and copy the "Setup key"
3. Add the SETUP_KEY variable in .env
4. Run the container:

docker run -it --name gpc --env-file .env \
    --volume $PWD/data:/home/appuser/data \
    globuspersonalconnect

If you see an error 'Setup Code XXX not found' this generally indicates that the setup key has expired. Keys are only valid for one use. An interactive terminal (-it) seems to be required for setup, but is not needed on later runs of the container.

Rather than persisting the container, you can also mount the ~/.globusonline directory as a volume to persist setup information across container restarts.

docker run -it --rm --name gpc --env-file .env \
    --volume $PWD/data:/home/appuser/data \
    --volume $PWD/.globusonline:/home/appuser/.globusonline \
    globuspersonalconnect

GUI

TODO needs update

The image contains python and Tk packages, allowing gui usage:

# You can change the volume to point to your data
docker run -it --rm --name gpc --volume $HOME/Datasets:/home/appuser/data globuspersonalconnect
# Run with gui
docker run -it --rm --name gpc -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix --volume $HOME/Datasets:/home/appuser/data globuspersonalconnect

# Run with gui
cd /globus # or whatever version you have
./globusconnectpersonal -setup # follow instructions to connect to your account
./globusconnectpersonal -gui # or -start to run in cli
# The gui will open, click connect to start the endpoint

On MacOS the gui requires XQuartz to be installed. You may also need to set xhost +localhost and use -e DISPLAY=host.docker.internal:0.