Instructions for getting setup with Docker for the ParFlow short course:

Note: The Docker image might take a while to download, so make sure you do these steps ahead of the workshop.

1. Follow the instructions here to create a Hydrogen account.
2. Make sure you have the latest version of Docker Desktop. Go to Docker and download Docker Desktop. Make sure you download the correct version based on your computer’s operating system and architecture. Follow the instructions to install Docker Desktop.
3. Launch Docker Desktop. The application should be running while you do the next steps. (You might need to create a Docker account and sign in if you don’t already have one.)
4. Start a new terminal session (outside Docker) to type the commands in the next two steps:
5. Pull the parflow/subsettools image from DockerHub. Choose the correct version based on your computer’s architecture. NOTE: If your Docker is running out of space, you might need to use docker system prune with the appropriate options to clear out old containers and make space for the new one.

• For the x86_64/amd64 (Intel Chip for Mac or Windows) architecture:

docker pull george135/subsettools_amd64

• For the arm64 (M1/M2 chip for Mac) architecture:

docker pull george135/subsettools_arm64

6. Once the image has finished downloading, you can run the container with:

• For the x86_64/amd64 architecture:

docker run -dp 8888:8888 george135/subsettools_amd64:latest start-notebook.sh --NotebookApp.token=''

• For the arm64 architecture:

docker run -dp 8888:8888 george135/subsettools_arm64:latest start-notebook.sh --NotebookApp.token=''

7. Use a browser to navigate to your JupyterLab container or use the link that will appear next to your container on the Docker Desktop application:
8. You should see a JupyterLab environment like this:
9. Click on the Terminal application to start a terminal session inside the container.
10. Clone the ParFlow short course GitHub repository:

git clone https://github.com/hydroframe/parflow_short_course_updated.git

11. Navigate to the gridding folder and click on the box_domain_setup_full.ipynb notebook.
12. Make sure the notebook runs successfully without errors.
13. Congratulations, you're all setup!