Home Assistant Community Add-on: Folding@home

This add-on is provided by the Home Assistant Community Add-ons project.

GitHub Release GitLab CI Project Stage Project Maintenance

Supports armhf Architecture Supports armv7 Architecture Supports aarch64 Architecture Supports amd64 Architecture Supports i386 Architecture


Fighting disease with a world wide distributed super computer.

Folding@home (FAH or F@h) is a distributed computing project for performing molecular dynamics simulations of protein dynamics. Its initial focus was on protein folding but has shifted to more biomedical problems, such as Alzheimer’s disease, cancer, Ebola and the coronavirus.

The project uses the idle processing resources of personal computers owned by volunteers who have installed the software on their systems. Now you can donate the idle time of your Home Assistant instance to the Folding@home project, helping to fight these diseases.

Join the Home Assistant Folding@home team! (id: 247478)

Team stats: https://stats.foldingathome.org/team/247478


The installation of this add-on is pretty straightforward and not different in comparison to installing any other Home Assistant add-on.

  1. Search for the “Folding@home” add-on in the add-on store.
  2. Install the “Folding@home” add-on.
  3. Start the “Folding@home” add-on.
  4. Check the logs of the “Folding@home” to see if everything went well.
  5. Open the Web UI.

Note: By default, the add-on joins the Home Assistant team (id: 247478).

Team stats: https://stats.foldingathome.org/team/247478


You can always try to get support from the community here at the Home Assistant community forums, join the conversation!

Questions? You have several options to get them answered:

You could also open an issue on GitHub, in case you ran into a bug, or maybe you have an idea on improving the addon:

:information_source: At this moment our Home Assistant Community Add-ons Discord chat server and GitHub are our only official support channels. All others rely on community effort.

Repository on GitHub

Looking for more add-ons?

The primary goal of our add-ons project is to provide you (as a Home Assistant user) with additional, high quality, add-ons that allow you to take your automated home to the next level.

Check out some of our other add-ons in our Home Assistant Community Add-ons project.


About the author of this add-on

Hi there!

I am Franck Nijhof, and I have 30 years of programming experience, in many languages. I am using this experience to work on the Home Assistant project by giving back my knowledge and time to the open source community.

The add-on you are currently looking at right now was developed/packaged by me. It is not the only add-on I have created; there are many many more :wink:

Enjoy your add-on!


Join our Discord server Follow me on Twitter Flollow me on Instragram Follow me on GitHub Follow me on YouTube Follow me on Twitch

P.S.: In case you want to ask me a question: AMA (Ask Me Anything). Most of the time I am online at the Discord chat. (I go by @Frenck in there as well).


Thx for your idea and development with social sharing action.

I wish Human can control the disease some day.


Thank you very much for this add-on! I have installed it and waiting for an assignment.

Been a while since I had this installed, and now it’s a HA Addon!!! awesome job :slight_smile:

Only issue I seem to be having is that I’m not getting any WU? is this just me?

That is not just you, since they added the coronovirus they had an enormous boost in donators. As far as I understand, they are currently scaling up.

Work drops in slowly.

1 Like

Would love to participate, but see it cannot be installed on an RPI (3b+)… what´s the reason for that?

The Folding@home project does not support ARM based machines (Raspberry Pi). Not much I can do about that. :man_shrugging:

thanks! shame :anguished:

@frenck nice idea, well done!
I just started folding but I don’t see any option for covid virus on the dropdown menu, is it a bug or a feature?

Covid is automatically given when selecting “Any”, see the folding@home website/blog for more information about this.

thanks :+1:

Thanks Bro

but im getting this

but the Web UI not working

I’m having a similar issue. Seems like the web UI has a problem with http vs https and it doesn’t like my duckdns URL. Clicking “Open Web UI” from the add-on page directs me to my duckdns URL ("https://XXXXXX.duckdns.org:7396/), which doesn’t load.

If I manually go to http://hassio.local:7396 or my local IP ("http://xxx.xxx.x.xxx:7396) the web UI loads, but constantly refreshes and won’t let me change any settings (can’t change CPU usage, user, passcode, etc.)

Yes I get this too

I also see the same thing but only in Chrome. Edge and IE seem to work much better.

1 Like

Thanks, yes Edge seems to work for me too…

great idea! I love your add-ons

are cpushares options used when running the container ?

I’m running Folding at Home on a seperate docker host, with cpushares <1024.
This will help prioritizing the docker host when there is a contingency with CPU resources.
1024 is the default for cpu shares.
When you make it lower for the folding at home container / plugin, you can let the FAHClient run on full power. Meanwhile the docker host enginer will give it less priority when there is cpu resource contention. Making sure the other containers are not pushed away by this container, when they need cpu resources.

Hey @frenck, great work on the add-on! If you or anyone else is interested, it looks like you get the F@H data back into HA via their API. I have the following sensors set up and it works well. You would just need to change out your user name at the end of the URL.

- platform: rest
  resource: https://stats.foldingathome.org/api/donor/jagee23
  name: Folding at Home Points
  value_template: '{{ value_json.credit }}'

- platform: rest
  resource: https://stats.foldingathome.org/api/donor/jagee23
  name: Folding at Home Work Units
  value_template: '{{ value_json.wus }}'

- platform: rest
  resource: https://stats.foldingathome.org/api/team/247478
  name: Folding at Home Team Points
  value_template: '{{ value_json.credit }}'

- platform: rest
  resource: https://stats.foldingathome.org/api/team/247478
  name: Folding at Home Team Work Units
  value_template: '{{ value_json.wus }}'