README.md

GEOS639 Docker Image

Quickstart

We recommend using a Linux distribuion -- either native Linux or Windows Subsystem for Linux (WSL) on Windows.

• WSL 2 Installation Instructions

This image is provided through Docker. Ensure that you have Docker installed for your operating system:

• Linux instructions
  • Select your Linux flavor from the left sidebar menu.
• Windows Instructions using WSL 2
  • Be sure to follow the WSL2 backend-specific instructions.
• Mac Instructions

This image is also available on the GitHub Container Registry. Pull it onto your computer with

docker pull ghcr.io/asfopensarlab/geos639-image:main

you can then run the image with

docker run -it --init --rm -p 8888:8888 -v $HOME/jupyter-data:/home/jovyan ghcr.io/asfopensarlab/geos639-image:main

Click the 127.0.0.1:8888 link that appears, and you should be able to access the image.

Volume Permissions

If your user account is not the first account on your machine, or more specifically does not have UID=1000, the jupyter-data directory will not belong to your account. If you encounter permission errors, you can take ownership of the directory with

sudo chown -R <YOUR_USERNAME> jupyter-data

If you do this, you may encounter permission errors when starting the container (/home/jovyan is not writable). In this case, reset the permissions to their original state with

sudo chown -R 1000:100 jupyter-data

Building From Source

After cloning the repository, building and running the image should be as simple as running make in your terminal!