README.md 1.27 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
## Partial software list
* CLHEP
* DD4hep
* GEANT4
9
* GenFit
10
* LCIO
11
* NPDet
12 13 14 15
* proio
* Protobuf
* ROOT

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

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

Example:
David Blyth's avatar
David Blyth committed
31 32 33 34
```shell
singularity pull docker://argonneeic/base
./base.img
```
35 36 37 38 39 40 41 42 43 44
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
45 46 47 48

# Building the image
Example:
```shell
49
docker build -t baseimg --build-arg BUILD_THREADS=10 https://eicweb.phy.anl.gov/EIC/BaseImage.git
David Blyth's avatar
David Blyth committed
50
```
David Blyth's avatar
David Blyth committed
51 52

# Contact
David Blyth's avatar
David Blyth committed
53
For additional information, contact the maintainer [David Blyth](mailto:dblyth@anl.gov)