Running Fluidity with Docker

Install Docker

See the comprehensive instructions provided by Docker at http://docs.docker.com/engine/installation/

Starting a Fluidity image

Once your docker install is working, run:

docker pull fluidity/release
docker run -it fluidity/release bash -il

You will now be at a command prompt where you can run 'fluidity' in the standard Ubuntu LTS environment. For more details on run options such as how to export files into and out of the Docker container, see the Docker manual at https://docs.docker.com/engine/reference/run/

For example, you might want to export a working directory to the container, and run a job in it:

docker run -v /data/fluidity-input:/rundir -a stdout -t fluidity/release fluidity -V myjob.flml

Note that by default the container runs with the user 'fluidity', user ID 1000. You may well want to modify your container to run with your username and user ID, with the use of a simple Dockerfile such as:

FROM fluidity/release
USER root
RUN adduser --disabled-password --gecos "" -u 61745 -U 6558 annesmith
USER annesmith

Then build the updated container in the directory containing the Dockerfile with:

docker build -t my-fluidity-container .

And run in your container with:

docker run -v /data/fluidity-input:/rundir -a stdout -t my-fluidity-container fluidity -V myjob.flml