dont-stop-folding/DOCS.md

Folding@home Add-on Dokumentation

Über dieses Add-on

Dieses Add-on führt den Folding@home Client (Version 8.x) als Home Assistant Add-on aus. Folding@home ist ein verteiltes Rechenprojekt, das die Rechenleistung deines Computers nutzt, um Proteinfaltungssimulationen für medizinische Forschung durchzuführen (z. B. Alzheimer, Krebs, COVID-19).

---

Installation

1. Öffne Home Assistant und gehe zu: Einstellungen → Add-ons → Add-on Store
2. Klicke oben rechts auf ⋮ → Repositories
3. Füge folgende URL hinzu:

   https://gitea.bitfire.work/retr0/dont-stop-folding
   

4. Schließe den Dialog – das Add-on „Folding@home" erscheint nun im Store
5. Klicke auf das Add-on und dann auf Installieren
6. Konfiguriere die gewünschten Optionen (siehe unten)
7. Klicke auf Starten

---

Konfiguration

Optionen

Option	Typ	Standard	Beschreibung
user	string	(leer)	Dein Folding@home-Benutzername. Wird für die Statistikseite verwendet.
team	string	247478	Team-ID. 247478 ist das offizielle Home Assistant Team.
passkey	string	(leer)	Dein persönlicher Passkey von foldingathome.org. Aktiviert Bonus-Punkte.
power	Auswahl	medium	Leistungsstufe: light, medium oder full.
account_token	string	(leer)	Token für das neue FAH 8 Online-Konto (von foldingathome.org).
machine_name	string	(leer)	Anzeigename dieser Maschine im FAH-Online-Konto.

Beispielkonfiguration

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

Mit FAH 8 Online-Konto:

account_token: "eyJ..."
machine_name: "homeassistant"
power: "full"

Leistungsstufen

Stufe	Beschreibung
light	Niedrige CPU-Last, läuft im Hintergrund ohne spürbaren Einfluss
medium	Moderate Last (Standardwert)
full	Maximale Rechenleistung, kann das System spürbar belasten

---

Web-Interface

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

http://<homeassistant-ip>:7396

Dort kannst du:

• Aktuelle Work Units und Fortschritt einsehen
• Die Leistungsstufe manuell anpassen
• Folding pausieren oder fortsetzen
• Statistiken abrufen

---

Zwei Kontosysteme

Folding@home bietet zwei Möglichkeiten, Punkte zu sammeln:

Klassisch (user + passkey)

Das bewährte System – erstelle einen Account auf foldingathome.org, trage Benutzernamen und optional einen Passkey ein.

FAH 8 Online-Konto (account_token)

Das neue System seit Version 8. Erstelle ein Konto auf foldingathome.org, generiere einen Token und trage ihn unter account_token ein. machine_name gibt der Maschine einen erkennbaren Namen in deinem Konto-Dashboard.

Hinweis: Beide Systeme können nicht gleichzeitig aktiv sein. Wenn account_token gesetzt ist, wird er bevorzugt. Ohne beides wird anonym gefaltet.

---

Datenspeicherung

Der FAH Client speichert seine Konfiguration und Work-Unit-Daten im Home Assistant Konfigurationsverzeichnis unter:

/config/  (innerhalb des Containers)

Die Daten bleiben bei Neustarts und Updates des Add-ons erhalten.

---

Unterstützte Architekturen

Architektur	Unterstützt
amd64	✓
aarch64	✓
armhf	✗ (vom FAH 8 Client nicht unterstützt)
armv7	✗ (vom FAH 8 Client nicht unterstützt)

---

Problembehandlung

Add-on startet nicht

• Prüfe im 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 zum Initialisieren
• Prüfe, ob das Add-on im Status „Läuft" angezeigt wird

Keine Punkte / kein Fortschritt

• Der FAH Server weist Work Units zu – bei geringer Auslastung der Server kann es zu Wartezeiten kommen
• Prüfe im Web-Interface unter http://<ip>:7396, ob aktiv gefaltet wird
• Stelle sicher, dass user und team korrekt eingetragen sind

Anonym falten

Wenn weder user noch account_token gesetzt sind, werden Beiträge unter dem anonymen Benutzer gesammelt. Die Leistung ist identisch, nur die Statistiken werden keinem Konto zugeordnet.