terribleplan/folding-at-home-docker-gpu
1
0
Fork 0
Code Releases Activity

Update 'README.md'

Browse source
This commit is contained in:
Kegan Myers 2020-04-19 22:27:18 +00:00
parent 3fd7602dce
commit 23c42b30e6
1 changed files with 15 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -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.
Right now, to the best of my knowledge, they are the
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.
This is a fork of [this](https://github.com/wandhydrant/folding-at-home-docker-gpu)
repo with minor modifications to make pre-built images.
## Usage
### Build the image locally
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:
### Run it:
GPU access by containers went through several stages:
first direct export of /dev/dri and other devices; then
@ -53,7 +33,7 @@ docker run -d \
-e ENABLE_GPU=true \
-e ENABLE_SMP=true \
--restart unless-stopped \
my-fah-nvidia-image \
terribleplan/folding-at-home-docker-gpu:latest \
--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
```
### (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
- 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:
```
docker run my-fah-nvidia-image --help
docker run terribleplan/folding-at-home-docker-gpu --help
```