codingcoffee/fahclient

By codingcoffee

Updated over 5 years ago

Dockerized Folding@home client with nvidia GPU support to help battle COVID-19

Image
3

50K+

codingcoffee/fahclient repository overview

Dockerized FAHClient


License Docker Pulls Docker Image Size (tag) Docker Image CI

Folding@home (FAH or F@h) is a distributed computing project for simulating protein dynamics, including the process of protein folding and the movements of proteins implicated in a variety of diseases. It brings together citizen scientists who volunteer to run simulations of protein dynamics on their personal computers. Insights from this data are helping scientists to better understand biology, and providing new opportunities for developing therapeutics.

Usage

  • CPU only
docker run -it --rm -d \
  --name fahclient \
  -p 7396:7396 \
  codingcoffee/fahclient \
  --allow 0/0  \
  --web-allow 0/0
  • CPU and GPU
docker run -it --rm -d \
  --name fahclient \
  --gpus all \
  -p 7396:7396 \
  -e ENABLE_GPU=true \
  codingcoffee/fahclient \
  --allow 0/0  \
  --web-allow 0/0

You can also visit the web dashboard by visiting http://localhost:7396 in your browser.

GPU Support

Since this image uses nvidia/cuda as it's base image, to use the GPU support, you'll need to have an NVIDIA GPU, and NVIDIA Container Toolkit installed on your system.

List of usable environment variables

Environment VaribleValueDefault
USERyour usernameAnonumous
TEAMyour team name0
PASSKEYyour passkey
ENABLE_GPUtrue/falsefalse
ENABLE_SMPtrue/falsetrue
POWERfull/medium/lightfull

FAQ

Q: How can I use this with Docker Compose?

A: Well, you can use it with docker compose if you don't want the GPU support. This is because docker compose still doesn't have the a way to specify the --gpu flag, or atleast I wasn't able to figure it out. If you did, open a issue / send a PR with the docker-compose.yml file.

Logs

To get the logs of the running container

d ocker logs -f fahclient

Build

To build the image locally

docker build -t codingcoffee/fahclient .

Contribution

Have better suggestions to optimize the image? Found some typos? Go ahead and send in a Pull Request! Contributions of any kind welcome!

LICENSE

The code in this repository has been released under the GNU General Public License v3

Tag summary

Content type

Image

Digest

Size

100.7 MB

Last updated

over 5 years ago

Requires Docker Desktop 4.37.1 or later.