{"id":17151454,"url":"https://github.com/stefancrain/folding-at-home","last_synced_at":"2025-04-13T12:04:59.590Z","repository":{"id":41883538,"uuid":"247979391","full_name":"stefancrain/folding-at-home","owner":"stefancrain","description":"A Folding@Home Docker container with GPU support","archived":false,"fork":false,"pushed_at":"2024-04-26T00:51:40.000Z","size":75,"stargazers_count":38,"open_issues_count":3,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T22:38:08.554Z","etag":null,"topics":["alzheimers-disease","amd64","covid-19","cpu","docker","folding-at-home","foldingathome","gpu-support","huntingtons-disease","nvidia-docker","opencl","parkinsons-disease"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefancrain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-03-17T13:39:07.000Z","updated_at":"2024-04-19T12:30:05.000Z","dependencies_parsed_at":"2024-04-26T01:44:07.384Z","dependency_job_id":"621b9d95-b87d-42d5-98f6-846237ca0574","html_url":"https://github.com/stefancrain/folding-at-home","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefancrain%2Ffolding-at-home","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefancrain%2Ffolding-at-home/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefancrain%2Ffolding-at-home/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefancrain%2Ffolding-at-home/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefancrain","download_url":"https://codeload.github.com/stefancrain/folding-at-home/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240072103,"owners_count":19743527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alzheimers-disease","amd64","covid-19","cpu","docker","folding-at-home","foldingathome","gpu-support","huntingtons-disease","nvidia-docker","opencl","parkinsons-disease"],"created_at":"2024-10-14T21:38:04.904Z","updated_at":"2025-02-23T10:32:07.063Z","avatar_url":"https://github.com/stefancrain.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Running Folding@Home in docker with GPU support\n\n![build](https://github.com/stefancrain/folding-at-home/workflows/folding-at-home/badge.svg)\n![auto-update](https://github.com/stefancrain/folding-at-home/workflows/folding-at-home/badge.svg?event=schedule)\n\n![GitHub Tag](https://badgen.net/github/tag/stefancrain/folding-at-home?icon=github\u0026label=version)\n![GitHub commit activity](https://badgen.net/github/last-commit/stefancrain/folding-at-home?icon=github\u0026label=updated)\n![Docker Layers](https://badgen.net/docker/pulls/stefancrain/folding-at-home?icon=docker\u0026label=pulls)\n![Docker Size](https://badgen.net/docker/size/stefancrain/folding-at-home/latest/amd64?icon=docker\u0026label=latest)\n![Docker Stars](https://badgen.net/docker/stars/stefancrain/folding-at-home?icon=docker)\n\n## Fighting COVID-19, and other diseases\n\nTL;DR: **Folding at home** is simulating the dynamics of COVID-19 proteins to hunt for new therapeutic opportunities. This container distributes the binary in a hope to increase installs.\n\n### FAH links\n\n- [[FAQ] SARS-CoV-2 (COVID-19) projects and FAH](https://foldingforum.org/viewtopic.php?f=24\u0026t=32463)\n- [Coronavirus, what were doing and how you can help in simple terms](https://foldingathome.org/2020/03/15/coronavirus-what-were-doing-and-how-you-can-help-in-simple-terms/)\n- [Live footage of our scientists working hard to make more work units available](https://twitter.com/foldingathome/status/1239992073664765953)\n\n## Unofficial, Unsupported\n\nI'm not a member of the F@H team. I actively work on issues here, and have set this up to [automatically update](.github/workflows/schedule.yml) in my absence. This image is published to [stefancrain/folding-at-home](https://hub.docker.com/repository/docker/stefancrain/folding-at-home) and automatically updated as the folding-at-home team releases changes.\n\n## Prerequisites\n\n- CPU: amd64\n- GPU: Nvidia and AMD\n  - [A F@H supported GPU](https://apps.foldingathome.org/GPUs.txt)\n  - [NVIDIA/nvidia-docker](https://github.com/NVIDIA/nvidia-docker) - A [gist](https://gist.github.com/stefancrain/0b4fe2ae29a15427a5d7040a9f7cdb5c) from my headless ubuntu 18.04 setup\n  - TODO: add AMD gist\n\n## Deployment\n\n### CLI docker run\n\n```bash\ndocker run \\\n  --name folding-at-home \\\n  --gpus all \\\n  -p 7396:7396 \\\n  stefancrain/folding-at-home:latest \\\n  --user=YOUR_NAME_HERE \\\n  --team=229500 \\\n  --power=full \\\n  --gpu-usage=100 \\\n  --cpu-usage=100\n```\n\n### Docker-compose\n\nDocker-compose GPU access is currently blocked by upstream issue in compose [#6691](https://github.com/docker/compose/issues/6691), tracked in [#4](https://github.com/stefancrain/folding-at-home/issues/4). **This will work for CPU folding only** :\n\n```bash\n---\nversion: \"3\"\nservices:\n  folding-at-home:\n    image: stefancrain/folding-at-home:latest\n    container_name: folding-at-home\n    ports:\n      - 7396:7396\n    restart: unless-stopped\n    command: [\"--user=YOUR_NAME_HERE\",\"--team=229500\",\"--power=full\",\"--gpu=false\",\"--cpu-usage=100\"]\n```\n\n### K8s\n\nI don't currently have a K8s cluster at home, so I'm including examples of users running this image in their config.\n\n- [onedr0p/k3s-gitops](https://github.com/onedr0p/k3s-gitops/blob/fdc4be556833d3fcc4849b54cc248eb1a9c89dcc/deployments/default/folding-at-home/folding-at-home.yaml) works great but /u/onedrop has no approved GPUs to test\n- [coreweave/fah-docker](https://github.com/coreweave/fah-docker/blob/master/kubernetes/folding-at-home-deployment.yaml) (a different container) but the config to support GPU enabled docker container, untested (by me)\n\nTODO: create k8s cluster and test!\n\n## Troubleshooting and FAQ\n\n### nvidia-docker\n\n\u003e Is your `docker run` aborting with error `could not select device driver \"\" with capabilities: [[gpu]]`?\n\nPlease be sure you installed `nvidia-docker` as indicated in the 'Prerequisites' section above.\n\n### Nvidia\n\n\u003e Does docker see all GPUs?\n\n```bash\ndocker run \\\n --rm \\\n --gpus all \\\n --entrypoint=\"nvidia-smi\" \\\n stefancrain/folding-at-home:latest\n```\n\n### FAHClient\n\n\u003e What are the FAHClient defaults set for this container?\n\n- **User** : Anonymous\n- **Team** : [Homelab - 229500](https://stats.foldingathome.org/team/229500) [_who?_](https://www.reddit.com/r/homelab/comments/fkyr1i/foldinghome_homelab_team_against_covid19/)\n- **Power** : full (use full CPU)\n- **gpu-usage** : 100%\n- **cpu-usage** : 100%\n- **web-allow/allow** : allow web traffic to port 7396\n- **smp** : [support smp](https://foldingathome.org/2008/06/15/what-does-the-smp-core-do/)\n\n\u003e How do I review my FAHClient config?\n\n```bash\ndocker run \\\n --rm \\\n --gpus all \\\n --entrypoint=\"/usr/bin/FAHClient\" \\\n stefancrain/folding-at-home:latest \\\n --info\n```\n\n\u003e How can I see additional config options?\n\n```bash\ndocker run \\\n --rm \\\n --entrypoint=\"/usr/bin/FAHClient\" \\\n stefancrain/folding-at-home:latest \\\n --help\n```\n\n\u003e How can I see my progress?\n\nBy default the container is open to local network traffic on [127.0.0.1:7396](http://127.0.0.1:7396/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefancrain%2Ffolding-at-home","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefancrain%2Ffolding-at-home","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefancrain%2Ffolding-at-home/lists"}