Folding@home ist ein verteiltes Rechenprojekt der Washington University in St. Louis. Es simuliert die Faltung von Proteinen – also den Prozess, durch den sich Eiweißmoleküle zu ihrer dreidimensionalen Funktionsform falten. Fehler in diesem Prozess stehen im Zusammenhang mit Krankheiten wie Alzheimer, Parkinson, Krebs und COVID-19.

Jeder Computer, der am Projekt teilnimmt, berechnet kleine Simulationsaufgaben (sogenannte Work Units) und sendet die Ergebnisse an die Forschungsserver zurück. Mit diesem Add-on läuft der Folding@home Client direkt auf deinem Home Assistant Server – vollständig im Hintergrund, ohne separate Hardware.

Features

Folding@home Client 8.x – aktuelle Version mit verbesserter Effizienz
Web-Interface auf Port 7396 – Fortschritt, Statistiken und Steuerung direkt im Browser
Zwei Kontosysteme – klassisch (Benutzername + Passkey) oder FAH 8 Online-Konto (Account Token)
Team-Support – standardmäßig im Home Assistant Community Team (247478)
Persistenz – Work-Unit-Daten und Konfiguration bleiben bei Updates erhalten
Unterstützte Architekturen: amd64, aarch64

Installation

Öffne Home Assistant und navigiere zu: Einstellungen → Add-ons → Add-on Store
Klicke oben rechts auf ⋮ → Repositories und füge folgende URL hinzu:
```
https://gitea.bitfire.work/retr0/dont-stop-folding
```
Schließe den Dialog – das Add-on Folding@home erscheint nun im Store.
Klicke auf das Add-on und dann auf Installieren.
Wechsle in den Tab Konfiguration und trage deine Daten ein (siehe unten).
Klicke auf Starten.

Konfiguration

Optionen

Option	Typ	Standard	Beschreibung
`user`	string	(leer)	Dein Folding@home-Benutzername für die Statistikseite.
`team`	string	`247478`	Team-ID. `247478` ist das offizielle Home Assistant Community Team.
`passkey`	string	(leer)	Persönlicher Passkey von foldingathome.org. Aktiviert Bonus-Punkte (Quick Return Bonus).
`account_token`	string	(leer)	Token für das FAH 8 Online-Konto. Empfohlen für neue Nutzer.
`machine_name`	string	(leer)	Anzeigename dieser Maschine im FAH-Konto-Dashboard.

Beispielkonfigurationen

Klassisches Konto (user + passkey):

user: "mein_benutzername"
team: "247478"
passkey: "abc123..."

FAH 8 Online-Konto:

account_token: "eyJ..."
machine_name: "homeassistant"

Anonym falten (keine Einträge nötig – einfach leer lassen):

team: "247478"

Hinweis: account_token und user/passkey schließen sich gegenseitig aus. Wenn account_token gesetzt ist, wird er bevorzugt. Ohne beides wird anonym gefaltet.

Web-Interface

Nach dem Start ist die Folding@home Web-UI erreichbar unter:

http://<homeassistant-ip>:7396

Über das Web-Interface kannst du:

Aktuelle Work Units und deren Fortschritt einsehen
Folding pausieren und fortsetzen
Die Leistungsstufe (light / medium / full) anpassen
CPU- und GPU-Slots konfigurieren
Statistiken und deinen Beitrag abrufen

Kontosysteme im Vergleich

Folding@home bietet zwei Möglichkeiten, Beiträge einem Konto zuzuordnen:

Klassisch – Benutzername + Passkey

Das bewährte System. Erstelle einen Account auf foldingathome.org, trage deinen Benutzernamen unter user ein. Mit einem optionalen passkey werden Bonus-Punkte freigeschaltet (Quick Return Bonus), die vergeben werden, wenn Work Units pünktlich abgegeben werden.

FAH 8 Online-Konto – Account Token

Das neue System ab Version 8. Nach der Registrierung auf foldingathome.org generierst du einen Token im Web-Dashboard und trägst ihn unter account_token ein. Optional kannst du unter machine_name einen Namen vergeben, damit du mehrere Maschinen im Dashboard unterscheiden kannst.

Unterstützte Architekturen

Architektur	Status
`amd64`	✅ Unterstützt
`aarch64`	✅ Unterstützt (z. B. Raspberry Pi 4/5 mit 64-Bit-OS)
`armhf`	❌ Nicht unterstützt (FAH 8 Client nicht verfügbar)
`armv7`	❌ Nicht unterstützt (FAH 8 Client nicht verfügbar)

Datenspeicherung

Der FAH Client speichert Konfiguration und Work-Unit-Daten persistent im Home Assistant Konfigurationsverzeichnis. Die Daten bleiben bei Neustarts und Add-on-Updates vollständig erhalten.

Problembehandlung

Add-on startet nicht

Prüfe den Log-Tab des Add-ons auf Fehlermeldungen.
Stelle sicher, dass Port 7396 nicht von einem anderen Dienst belegt ist.

Web-Interface nicht erreichbar

Warte 30–60 Sekunden nach dem Start – der FAH Client benötigt etwas Zeit zur Initialisierung.
Prüfe, ob das Add-on im Status Läuft angezeigt wird.

Kein Fortschritt / keine Work Units

Der FAH-Server weist Work Units zu. Bei hoher Auslastung der Forschungsserver kann es zu Wartezeiten kommen – das ist normal.
Prüfe im Web-Interface, ob der Client verbunden ist.
Stelle sicher, dass user und team korrekt eingetragen sind.
Für FAH 8: Ohne gültigen account_token werden keine Work Units zugeteilt. Anonymes Falten funktioniert in FAH 8 nur eingeschränkt.

Beiträge erscheinen nicht in der Statistik

Statistiken werden verzögert aktualisiert (bis zu mehrere Stunden).
Stelle sicher, dass user korrekt geschrieben ist (Groß-/Kleinschreibung zählt).
Mit einem passkey werden Punkte zuverlässiger zugeordnet.

Lizenz

MIT License – siehe LICENSE.txt

readme.md Unescape Escape

dont-stop-folding

Was ist Folding@home?