• Docker 17.05 or higher


This Dockerfile will build and install HELICS in Ubuntu 22.04 with Python support.

FROM ubuntu:22.04 as builder

WORKDIR /root/develop

RUN apt update && apt install -y \
  libzmq5-dev python3-dev \
  libboost-all-dev \
  build-essential swig cmake git

RUN git clone --recurse-submodules \ helics

WORKDIR /root/develop/helics

RUN cmake \
  -B build

RUN cmake --build build -j -t install

FROM ubuntu:22.04

COPY --from=builder /helics /usr/local/

ENV PYTHONPATH /usr/local/python

# Python must be installed after the PYTHONPATH is set above for it to
# recognize and import
RUN apt update && apt install -y --no-install-recommends \
  libboost-filesystem1.74.0 libboost-program-options1.74.0 \
  libboost-test1.74.0 libzmq5 pip python3-dev

RUN pip install helics

CMD ["python3", "-c", "import helics; print(helics.helicsGetVersion())"]


To build the Docker image, run the following from the directory containing the Dockerfile:

$ docker build -t helics .


To run the Docker image as a container, run the following:

$ docker run -it --rm helics

Doing so should print the version and exit.