Update 'README.md'
This commit is contained in:
parent
3fd7602dce
commit
23c42b30e6
41
README.md
41
README.md
|
@ -1,31 +1,11 @@
|
||||||
# Folding@Home Dockerfile for Nvidia GPUs
|
# Folding@Home Docker Image Builds for Nvidia GPUs [![Build Status](https://jenkins.home.keganmyers.com/buildStatus/icon?job=folding-at-home-docker-gpu)](https://jenkins.home.keganmyers.com/job/folding-at-home-docker-gpu/)
|
||||||
|
|
||||||
Folding@home is a project focused on disease research.
|
This is a fork of [this](https://github.com/wandhydrant/folding-at-home-docker-gpu)
|
||||||
Right now, to the best of my knowledge, they are the
|
repo with minor modifications to make pre-built images.
|
||||||
only GPU-based distributed computing project who
|
|
||||||
are running calculations against Coronavirus.
|
|
||||||
|
|
||||||
Here is a combination of [Nikolay Yurin's Folding@home Dockerfile](https://github.com/yurinnick/folding-at-home-docker)
|
|
||||||
and the [BOINC Nvidia Dockerfile](https://github.com/BOINC/boinc-client-docker),
|
|
||||||
so that you have an additional layer of sandboxing around
|
|
||||||
GPU computations of Folding@home. In case you are allowed
|
|
||||||
to use other people's computers, or your employer's,
|
|
||||||
using Docker containers might even be a requirement.
|
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
### Build the image locally
|
### Run it:
|
||||||
|
|
||||||
I did not set up anything pre-built on the Docker hub.
|
|
||||||
|
|
||||||
Please inspect the Dockerfile and build the image yourself:
|
|
||||||
|
|
||||||
```
|
|
||||||
cd <git-checkout>
|
|
||||||
docker build -t my-fah-nvidia-image .
|
|
||||||
```
|
|
||||||
|
|
||||||
### and run it:
|
|
||||||
|
|
||||||
GPU access by containers went through several stages:
|
GPU access by containers went through several stages:
|
||||||
first direct export of /dev/dri and other devices; then
|
first direct export of /dev/dri and other devices; then
|
||||||
|
@ -53,7 +33,7 @@ docker run -d \
|
||||||
-e ENABLE_GPU=true \
|
-e ENABLE_GPU=true \
|
||||||
-e ENABLE_SMP=true \
|
-e ENABLE_SMP=true \
|
||||||
--restart unless-stopped \
|
--restart unless-stopped \
|
||||||
my-fah-nvidia-image \
|
terribleplan/folding-at-home-docker-gpu:latest \
|
||||||
--allow 0/0 --web-allow 0/0
|
--allow 0/0 --web-allow 0/0
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -67,6 +47,15 @@ pointing your browser at the container:
|
||||||
echo http://$(docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" folding-at-home):7396
|
echo http://$(docker inspect --format "{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}" folding-at-home):7396
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### (optional) Build the image yourself
|
||||||
|
|
||||||
|
If you do not wish to use pre-built images you can build it yourself:
|
||||||
|
|
||||||
|
```
|
||||||
|
cd <git-checkout>
|
||||||
|
docker build -t my-fah-nvidia-image .
|
||||||
|
```
|
||||||
|
|
||||||
## Parameters
|
## Parameters
|
||||||
|
|
||||||
- USER - Folding@home username (default: Anonymous)
|
- USER - Folding@home username (default: Anonymous)
|
||||||
|
@ -79,5 +68,5 @@ echo http://$(docker inspect --format "{{range .NetworkSettings.Networks}}{{.IP
|
||||||
Additional configuration parameters can be passed as command line arguments. To get the full list of parameters run:
|
Additional configuration parameters can be passed as command line arguments. To get the full list of parameters run:
|
||||||
|
|
||||||
```
|
```
|
||||||
docker run my-fah-nvidia-image --help
|
docker run terribleplan/folding-at-home-docker-gpu --help
|
||||||
```
|
```
|
||||||
|
|
Loading…
Reference in a new issue