README.md 1.14 KB
Newer Older
David Blyth's avatar
David Blyth committed
1 2 3 4
# About
This repository contains a Dockerfile for building a base container image for a
variety of uses in the context of EIC studies at ANL.

5 6 7 8 9 10 11
## Partial software list
* CLHEP
* DD4hep
* GEANT4
* iLCUtil
* lcgeo
* LCIO
12
* NPDet
13 14 15 16
* proio
* Protobuf
* ROOT

David Blyth's avatar
David Blyth committed
17 18
# Using the image
## Docker
19
Example:
David Blyth's avatar
David Blyth committed
20 21 22
```shell
docker run -it argonneeic/base
```
23 24 25
See [Docker
documentation](https://docs.docker.com/engine/reference/commandline/cli/) for
more command line options.
David Blyth's avatar
David Blyth committed
26 27

## Singularity
28 29 30 31
Singularity v2.3+ is recommended.  If compactness of the image is a priority,
use v2.4+.

Example:
David Blyth's avatar
David Blyth committed
32 33 34 35
```shell
singularity pull docker://argonneeic/base
./base.img
```
36 37 38 39 40 41 42 43 44 45
Please see [the singularity
documentation](http://singularity.lbl.gov/quickstart) for more information.

In the above scenario, by default the user's `.bashrc` file will be executed
upon starting the container.  This can cause problems in some cases.  If it
seems that the environment is being negatively affected by the user's
`.bashrc`, one may avoid executing the script like so:
```shell
singularity exec base.img bash --norc
```
David Blyth's avatar
David Blyth committed
46 47 48 49

# Building the image
Example:
```shell
50
docker build -t baseimg --build-arg BUILD_THREADS=10 .
David Blyth's avatar
David Blyth committed
51
```