Skip to content

Docker Container Summary

Jump to bottom
Gary Pavlis edited this page Feb 5, 2024 · 4 revisions

Docker Container Summary

There are multiple versions of the MsPASS docker. This page is a summary to use as a reference to help anyone understand the differences. Cut-and-paste lines for docker pull for all of these versions can be found here

  1. The standard container has the base name mspass/mspass. It is what you should use for production work. It has C++ code compiled in optimize mode and contains all the required components of the framework.
  2. Versions with other tags are best pulled from ghcr.io. Full uses are:

docker pull ghcr.io/mspass-team/mspass:master

docker pull ghcr.io/mspass-team/mspass:latest

docker pull ghcr.io/mspass-team/mspass:nightly

docker pull ghcr.io/mspass-team/mspass:mpi

  1. The "dev" tag container has additional packages installed to make debugging within the container. Use it if you find the need to debug problem code. It can be pulled with either of the following commands:

docker pull mspass/mspass:dev

docker pull ghcr.io/mspass-team/mspass:dev

  1. Tagged release versions have a specific tag. e.g. to pull the older v1.0 container use:

docker pull ghcr.io/mspass-team/mspass:v1.0.0

Stable versions will work with either intel or arm64 (the new Apple chip introduced around 2020) architecture machines. Volatile copies like "hightly" and the "latest" do not include the arm64 support because of a performance problem at present on github. If you get a warning like the following:

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested

Add the line --platform linux/amd64 to the docker run command. e.g. this is the run line for the latest dev tagged container:

docker run --platform linux/amd64 -p 8888:8888 ghcr.io/mspass-team/mspass:dev

or the more common form binding the current directory for use with the container:

docker run -p 8888:8888 --mount src=`pwd`,target=/home,type=bind --platform linux/amd64 ghcr.io/mspass-team/mspass:dev
Clone this wiki locally