Running the ALPS Docker container

Jump to: navigation, search

Docker is a Linux containers platform that provides the possibility to easily build, ship and run many applications. It runs natively on Linux systems, but it is also works smoothly on Mac and Windows thanks to very light virtual machines that wrap the Docker Engine system.

The latest ALPS releases have also been distributed for Docker containers. This is advised for users that want to try out ALPS and maybe follow some of our tutorials during summer schools. If you intend to perform production calculations, for example using a high performance computing cluster, we suggest to install ALPS from sources, because it allows more customization and you might profit from more hardware-specific optimizations.

Next we suppose you have already Docker running on your machine, in case this is the first time, you should first skip to the last section of this document.


Cmd line interface

Pull the image (refer to the list of available tags for pulling a specific version)

docker pull dolfim/alps:latest

Generate XML parameters from a text file named "parms"

docker run -v `pwd`:/output alps parameters2xml parms

Run the spinmc application

docker run -v `pwd`:/output alps spinmc --write-xml

IPython Notebook interface

We also provide containers which run an IPython Notebook to which you can connect from the browser. This kind containers are labelled with the "-notebook" suffix.

With just one command you can get pull the image and start serving ALPS on port 8888.

docker run -p 8888:8888 dolfim/alps:2.2b4-notebook

Just open you browser and visit the page


Advanced version. See README on Docker hub.

Installing Docker

Please refer to the official Docker documentation. Some example installation will be added in the future.