openmpp/openmpp-run

openmpp/openmpp-run repository overview

⁠Docker images to run openM++ models

Pull the image and use it to run openM++ models on Windows or Linux as single executable or on MPI cluster. This is a part of OpenM++⁠ open source microsimulation platform. Please visit our wiki⁠ for more information.

⁠Supported tags

openmpp/openmpp-run:windows-ltsc2025
openmpp/openmpp-run:debian
openmpp/openmpp-run:ubuntu
openmpp/openmpp-run:redhat

⁠`openmpp/openmpp-run:windows-ltsc2025`

Pull: docker pull openmpp/openmpp-run:windows-ltsc2025

GitHub: https://github.com/openmpp/docker/tree/master/ompp-run-win⁠

From: windows/servercore:ltsc2025

Installed: Visual C++ re-distributable runtime (VC 2022, VC 2019, 2017, 2015), Microsoft MPI, 7zip, curl

⁠`openmpp/openmpp-run:debian`

Pull: docker pull openmpp/openmpp-run:debian

GitHub: https://github.com/openmpp/docker/tree/master/ompp-run-debian⁠

From: debian:stable

Installed: Open MPI, SQLite, unixODBC

⁠`openmpp/openmpp-run:ubuntu`

Pull: docker pull openmpp/openmpp-run:ubuntu

GitHub: https://github.com/openmpp/docker/tree/master/ompp-run-ubuntu⁠

From: ubuntu:24.04

Installed: Open MPI, SQLite, unixODBC

⁠`openmpp/openmpp-run:redhat`

Pull: podman pull openmpp/openmpp-run:redhat

GitHub: https://github.com/openmpp/docker/tree/master/ompp-run-redhat⁠

From: rockylinux/rockylinux:9

Installed: Open MPI, SQLite, unixODBC

⁠How to use `openmpp/openmpp-run:windows-ltsc2025` image

To run openM++ model do:

docker run .... openmpp/openmpp-run:windows-ltsc2025 modelOne.exe

Examples:

docker run -v C:\my\models\bin:C:\ompp openmpp/openmpp-run:windows-ltsc2025 modelOne.exe
docker run -v C:\my\models\bin:C:\ompp openmpp/openmpp-run:windows-ltsc2025 mpiexec -n 2 modelOne_mpi.exe -OpenM.SubValues 16
docker run -v C:\my\models\bin:C:\ompp -e OM_ROOT=C:\ompp openmpp/openmpp-run:windows-ltsc2025 modelOne.exe

To start command prompt do:

docker run -v C:\my\models\bin:C:\ompp -it openmpp/openmpp-run:windows-ltsc2025 cmd /K

⁠How to use `openmpp/openmpp-run:debian` image

To run openM++ model do:

docker run ....options... openmpp/openmpp-run:debian ./modelOne

Examples:

docker run \
  -v $HOME/models:/home/models \
  -e OMPP_USER=models -e OMPP_GROUP=models -e OMPP_UID=$UID -e OMPP_GID=`id -g` \
  openmpp/openmpp-run:debian \
  ./modelOne

docker run \
  -v $HOME/models:/home/models \
  -e OMPP_USER=models -e OMPP_GROUP=models -e OMPP_UID=$UID -e OMPP_GID=`id -g` \
  openmpp/openmpp-run:debian \
  mpiexec -n 2 ./modelOne_mpi -OpenM.SubValues 16

Environment variables to pass your current user and home directory to container:

OMPP_USER=ompp   # default: ompp, container user name and HOME
OMPP_GROUP=ompp  # default: ompp, container group name
OMPP_UID=1999    # default: 1999, container user ID
OMPP_GID=1999    # default: 1999, container group ID

To start shell do:

docker run -it openmpp/openmpp-run:debian bash

⁠How to use `openmpp/openmpp-run:ubuntu` image

To run openM++ model do:

sudo docker run ....options... openmpp/openmpp-run:ubuntu ./modelOne

Examples:

sudo docker run \
  -v $HOME/models:/home/models \
  -e OMPP_USER=models -e OMPP_GROUP=models -e OMPP_UID=$UID -e OMPP_GID=`id -g` \
  openmpp/openmpp-run:ubuntu \
  ./modelOne

sudo docker run \
  -v $HOME/models:/home/models \
  -e OMPP_USER=models -e OMPP_GROUP=models -e OMPP_UID=$UID -e OMPP_GID=`id -g` \
  openmpp/openmpp-run:ubuntu \
  mpiexec -n 2 ./modelOne_mpi -OpenM.SubValues 16

Environment variables to pass your current user and home directory to container:

OMPP_USER=ompp   # default: ompp, container user name and HOME
OMPP_GROUP=ompp  # default: ompp, container group name
OMPP_UID=1999    # default: 1999, container user ID
OMPP_GID=1999    # default: 1999, container group ID

To start shell do:

sudo docker run -it openmpp/openmpp-run:ubuntu bash

⁠How to use `openmpp/openmpp-run:redhat` image

To run openM++ model do:

podman run ....options... openmpp/openmpp-run:redhat ./modelOne

Examples:

podman run \
  -userns=host \
  -v $HOME/models:/home/models:z \
  -e OMPP_USER=models \
  openmpp/openmpp-run:redhat \
  ./modelOne

podman run \
  -userns=host \
  -v $HOME/models:/home/models:z \
  -e OMPP_USER=models \
  openmpp/openmpp-run:redhat \
  mpiexec -n 2 ./modelOne_mpi -OpenM.SubValues 16

Environment variables to pass your current user and home directory to container:

OMPP_USER=ompp   # default: ompp, container user name and HOME dir

To start shell do:

podman run -it openmpp/openmpp-run:redhat bash

⁠License: MIT

OpenM++ licensed under MIT, image OS and components has it own licensing terms.

Tag summary

Recent tags

Content type

Image

Digest

sha256:2547cf0f1…

Size

1.5 GB

Last updated

21 days ago

docker pull openmpp/openmpp-run:windows-ltsc2025

This week's pulls

Pulls:

Last week

Learn more⁠