Skip to content
Salvador Navas edited this page Jul 2, 2026 · 1 revision

Docker

The repository includes a Docker-based JupyterLab environment for running notebooks with the scientific Python stack.

Requirements

  • Docker Desktop on macOS/Windows or Docker Engine on Linux.
  • Docker Compose v2.
  • Internet access during the first build.

Check:

docker --version
docker compose version

Build and Run

git clone https://github.com/navass11/pyhydra.git
cd pyhydra
docker compose -f docker/docker-compose.yml up --build

Open:

http://localhost:8888

JupyterLab is configured without token or password for local development. Do not expose this container directly to the internet.

Mounted Paths

Host path Container path Purpose
./notebooks /pyhydra/notebooks Editable notebooks.
./data /pyhydra/data Data workspace for downloads, model inputs and generated outputs.

Download Data Inside Docker

docker compose -f docker/docker-compose.yml exec jupyter pyhydra-get-data
docker compose -f docker/docker-compose.yml exec jupyter pyhydra-get-data manning_rugosidades

Downloaded files are written under /pyhydra/data/pilot_cases/..., mapped to ./data/pilot_cases/... on the host.

Stop and Rebuild

Stop:

docker compose -f docker/docker-compose.yml down

Rebuild:

docker compose -f docker/docker-compose.yml build --no-cache
docker compose -f docker/docker-compose.yml up

Run in background:

docker compose -f docker/docker-compose.yml up --build -d

Logs:

docker compose -f docker/docker-compose.yml logs -f jupyter

External Models

The Docker image provides the Python/Jupyter environment. It does not install commercial, Windows-specific or project-specific model runtimes such as HEC-HMS, HEC-RAS, SWAT+ or SFINCS project binaries. Those workflows may still require local model installations and mounted project folders.

Clone this wiki locally