dockagile/pygile repository overview

⁠Docker Commands Guide for PyGILE Project

⁠First install Docker Desktop

⁠Windows

• Docker Desktop (recommended) - Download from Docker's official site⁠

⁠macOS

• Homebrew - brew install --cask docker (requires Homebrew⁠ installed first)

⁠Linux

• Package Manager - sudo apt install docker.io (Ubuntu/Debian)

⁠Alternative for All Platforms

• Official Installation Script - curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh

⁠Quick Start for PyGILE Development

1. Pull the image: docker pull dockagile/pygile
2. Navigate to your PyGILE project directory
3. Run with volume mounting: docker run --name pygile -p 8888:8888 -v ${PWD}:/workspace/pygile dockagile/pygile
4. Access Jupyter at: http://localhost:8888⁠

⁠Platform-Specific Instructions

⁠Windows

# Pull the image
docker pull dockagile/pygile

# Run with volume mounting (PowerShell)
docker run --name pygile -p 8888:8888 -v ${PWD}:/workspace/pygile dockagile/pygile

# Run with volume mounting (Command Prompt)
docker run --name pygile -p 8888:8888 -v %cd%:/workspace/pygile dockagile/pygile

⁠Linux

# Pull the image (try ARM64 first, fallback to amd64 if needed)
docker pull --platform linux/arm64 dockagile/pygile || docker pull --platform linux/amd64 dockagile/pygile

# Run with volume mounting
docker run --name pygile -p 8888:8888 -v ${PWD}:/workspace/pygile dockagile/pygile

⁠macOS (Apple Silicon M1/M2/M3)

IMPORTANT: Always specify platform explicitly to avoid architecture issues.

# Pull with explicit platform
docker pull --platform linux/amd64 dockagile/pygile

# Run with explicit platform to avoid compatibility issues
docker run --platform linux/amd64 --name pygile -p 8888:8888 -v ${PWD}:/workspace/pygile dockagile/pygile

Required Setup for macOS:

1. Open Docker Desktop Settings
2. Go to "Features in Development"
3. Check "Use Rosetta for x86/amd64 emulation on Apple Silicon"
4. Apply & Restart

⁠How to build and run the PyGILE Docker container?

Open Docker Desktop and open PowerShell in your project directory.

Since you have a Dockerfile in the docker folder:

cd D:\JUPITER\JAPAN_MAY_JULY\GITHUB\pyGILE-main\docker [Adjust path based on your cloned folder location]
docker build -t pygile .

To run the container after building:

docker run --name pygile -p 8888:8888 pygile

OR; IF YOU WISH TO PULL AND RUN WITHOUT BUILDING

⁠How to pull the existing PyGILE image from Docker Hub and run?

Open Docker Desktop and open terminal:

docker pull dockagile/pygile

Run the container:

docker run dockagile/pygile

If you want to auto-delete when container stops:

docker run --rm dockagile/pygile

To run with the standard PyGILE container name:

docker run --name pygile dockagile/pygile

⁠How to connect to your PyGILE repo and run Jupyter?

⁠Installing Git

⁠Windows

1. Download Git from git-scm.com⁠
2. Run the installer and follow the setup wizard
3. Choose "Git from the command line and also from 3rd-party software"
4. Use the default options for other settings

⁠macOS

# Using Homebrew (recommended)
brew install git

# Or using Xcode Command Line Tools
xcode-select --install

⁠Linux

Ubuntu/Debian:

sudo apt update
sudo apt install git

Once Git is installed, clone this repository:

git clone https://github.com/Geoinformatics-Lab/PyGILE.git
cd PyGILE-main

⁠How to start the existing PyGILE container?

docker start pygile

Or for development container:

docker start pygile

⁠How to inspect the PyGILE container?

To see what containers are running:

docker ps

To get inside the running PyGILE container:

docker exec -it pygile bash

Or for development container:

docker exec -it pygile bash

To check PyGILE container details:

docker inspect pygile

To see all containers (including stopped):

docker ps -a

View PyGILE container logs:

docker logs pygile

Run PyGILE interactively:

docker run -it dockagile/pygile bash

⁠How to manage PyGILE containers and images?

To see all images:

docker images

To stop the PyGILE container:

docker stop pygile

To remove the PyGILE container:

docker rm pygile

To remove the PyGILE image:

docker rmi pygile
# or
docker rmi dockagile/pygile