throwfather
Ein selbst hostbares Darts-Wertungssystem. 301/501-Matches werden in der App Dart für Dart gezählt, und jedes beendete Match fließt in eine Glicko-2-Rangliste samt echter Darts-Statistik — bereitgestellt von einem Nuxt-Web-Interface samt API. Server, Datenbank und Identity Provider betreibst du selbst; nichts telefoniert nach Hause.
Was Throwfather ist
Die Büro-Dartscheibe, jetzt mit einer Rangliste, um die niemand gebeten hat. Zwei Komponenten: throwfather-server (Nuxt-Web-Interface + API, ein Docker-Image) und die Throwfather-App (native, Expo), die Matches zählt und dieselbe API nutzt. Das Darts-Geschwister von Rodfather.
X01-Scorer
301 oder 501, Double-Out oder Straight-Out, First to N Legs — in der App Dart für Dart gezählt, mit Checkout-Hinweisen. Ein Match wird als Liste der geworfenen Darts gespeichert; der Server spielt sie nach und lehnt Darts ab, die das Match nicht beenden.
Glicko-2 nach Leg-Differenz
Ratings werden aus dem Match-Log nachgerechnet, nie gespeichert. Ein 3–0 zählt als voller Sieg, ein 3–2 als 0,67 — eine knappe Niederlage kostet also weniger als eine Klatsche.
1v1, Doppel, Free-for-all
Einzel, 2v2-Doppel (jedes Paar als eine Seite bewertet) oder 3–8 Spieler im Free-for-all, bewertet nach Platzierung. Trainingsmatches werden gespeichert, aber nie gewertet.
Darts-Statistik
3-Dart-Average, First-9, 100+/140+/180, Checkout-Quote, höchstes Finish und bestes Leg — alles aus demselben Replay. Aufs Rating wirken sie nie.
Matches annullieren
Ein falsch gezähltes Match wird annulliert, nicht gelöscht: Es bleibt mit Begründung dokumentiert, und jedes Rating danach wird ohne es neu berechnet.
Selbst gehostet by design
Ein organisationsunabhängiges Docker-Image, gesamte Konfiguration zur Laufzeit. Kein Tenant, kein Account, kein Lizenzserver, kein layer418-Backend im Spiel.
Server deployen
Nichts über dein Realm, deinen Firmennamen oder deine URLs steckt zur Build-Zeit im Image — ein veröffentlichtes Image bedient jedes Deployment, alles wird beim docker run übergeben.
Keycloak-Client
Lege in deinem Realm einen confidential Client für das Web-Interface an, mit https://dein-host/auth/keycloak/callback als gültiger Redirect-URI.
3 Secrets erzeugen
Session-Secret (≥48 Zeichen), ein Base64-Token-Key mit 32 Bytes und ein Auth-Session-Secret. In Produktion erfindet der Server sie nicht für dich.
Container starten
Starte ghcr.io/layer418/throwfather-server mit diesen Secrets, der Realm-Basis-URL und den Client-Credentials. Das Schema wird beim Boot erstellt — kein Migrationsschritt.
Optional: App aktivieren
Setze NUXT_APP_CLIENT_ID auf einen zweiten, öffentlichen Keycloak-Client. Bleibt es leer, liefert GET /api/config 501 und die App meldet schlicht, dass diese Instanz sie nicht unterstützt.
# one image, zero build-time config — everything is passed at run time docker run -d \ -p 3000:3000 \ -v throwfather-data:/data \ -e NUXT_OIDC_SESSION_SECRET="$(openssl rand -base64 48)" \ -e NUXT_OIDC_TOKEN_KEY="$(openssl rand -base64 32)" \ -e NUXT_OIDC_AUTH_SESSION_SECRET="$(openssl rand -base64 48)" \ -e NUXT_OIDC_PROVIDERS_KEYCLOAK_BASE_URL="https://sso.example.com/realms/acme" \ -e NUXT_OIDC_PROVIDERS_KEYCLOAK_CLIENT_ID="throwfather-web" \ -e NUXT_OIDC_PROVIDERS_KEYCLOAK_CLIENT_SECRET="…" \ -e NUXT_OIDC_PROVIDERS_KEYCLOAK_REDIRECT_URI="https://darts.example.com/auth/keycloak/callback" \ -e NUXT_PUBLIC_ORG_NAME="Acme GmbH" \ -e NUXT_APP_CLIENT_ID="throwfather-app" # optional: enables the app ghcr.io/layer418/throwfather-server:latest # generate the three secrets once and keep them stable — # regenerating them invalidates every existing session.
SQLite oder PostgreSQL
Eine Umgebungsvariable entscheidet. Bleibt DATABASE_URL leer, nutzt der Server eine SQLite-Datei unter DB_PATH (im Image /data/throwfather.db) — die richtige Wahl für einen einzelnen Container mit gemountetem Volume.
Setze DATABASE_URL auf einen postgres://-Connection-String, wenn Pods unabhängig sein müssen: mehr als eine Replica, Rolling Updates oder kein Volume zum Anhängen. Auch die Web-Login-Sessions liegen in der Datenbank, jeder Pod kann sie also bedienen.
Eine Liga zwischen den Backends umzuziehen ist ein JSON-Dump von vier Tabellen, IDs bleiben erhalten — über die Admin-Seite (THROWFATHER_ADMINS setzen) oder die db-transfer-CLI. Der Import ist alles-oder-nichts und verweigert ein Ziel, das schon Matches hat. Der Dump taugt zugleich als Backup.
# SQLite (default) — single container + volume # DATABASE_URL unset → /data/throwfather.db # PostgreSQL — multiple replicas, rolling updates, # or no volume to attach DATABASE_URL="postgres://throwfather:…@db:5432/throwfather" # move a league between backends (or back it up): node server/db-transfer.ts export /data/dump.json node server/db-transfer.ts import /w/dump.json # tables: players, matches, match_players, match_voids
App nutzen
In der App steckt keine Server-URL. Sie wird einmal gebaut und funktioniert mit jeder selbst gehosteten Instanz: Beim ersten Start gibt man die Adresse des eigenen Servers ein, die App holt sich von dort die Auth-Parameter der Instanz.
Server eintragen
Im Setup-Screen gibt man die Adresse der eigenen Instanz ein. Die App normalisiert sie, liest GET /api/config und zeigt den gefundenen Organisationsnamen zur Bestätigung — eine vertippte Adresse, die zufällig HTTP 200 liefert, wird per Strukturprüfung abgelehnt, nicht stillschweigend akzeptiert.
Anmelden
Native OIDC Authorization Code + PKCE direkt gegen dein Keycloak, mit Issuer und öffentlicher Client-ID aus /api/config. Kein Passwort läuft jemals über die eigene UI der App.
Identifizieren
Tokens liegen im Keystore des Betriebssystems, /api/** wird mit Bearer-Token aufgerufen. GET /api/me ordnet dem Subject des Tokens einen Spieler-Datensatz zu — ein „wähle deinen Spieler“-Schritt entfällt.
Werfen
Match Dart für Dart zählen, dann Rangliste, Matches und Spielerstatistik ansehen. Kein Netz am Board? Beendete Matches warten auf dem Gerät und werden hochgeladen, sobald du wieder online bist — Wiederholungen sind sicher.
Die App braucht einen eigenen Keycloak-Client
Das Web-Interface nutzt einen confidential Client mit Secret. Eine mobile App kann kein Secret geheim halten und braucht daher einen zweiten, öffentlichen Client im selben Realm — mit deaktivierter Client-Authentifizierung, PKCE S256 und der Redirect-URI throwfather://auth.
Zeigt NUXT_APP_CLIENT_ID auf den confidential Web-Client, lehnt Keycloak den Token-Tausch der App mit unauthorized_client ab. Gleiches Symptom, wenn der Client existiert, die Client-Authentifizierung aber aktiviert bleibt.
Ein Audience-Mapper ist nicht nötig: Der Server prüft bei jedem App-Request, dass das Token für diesen Client ausgestellt wurde — über Keycloaks azp-Claim oder eine passende aud. Diese Prüfung ist nicht abschaltbar, sonst könnte ein Token für einen beliebigen anderen Client im Realm als App agieren.
# Keycloak → Clients → Create client client_id = "throwfather-app" client_auth = off # public client standard_flow = on direct_access_grants = off redirect_uri = "throwfather://auth" pkce = "S256" audience_mapper = not needed # then on the server container: NUXT_APP_CLIENT_ID = "throwfather-app"
Datenschutz
Kurzfassung: Die App erhebt keine Daten, und layer418 speichert keine. Die Daten deiner Liga existieren ausschließlich auf dem Throwfather-Server, in seiner Datenbank und im Keycloak-Realm, die du selbst hostest.
Die App erhebt keine Daten
Keine Analytics, keine Telemetrie, kein Crash- oder Performance-Reporting, keine Werbung, keine Tracking-IDs, keine Drittanbieter-SDKs, die nebenbei etwas sammeln. Es gibt keine Nutzungsdaten, denen man widersprechen müsste, weil keine erhoben werden.
Es gibt kein layer418-Backend
Die App wird ohne Server-URL ausgeliefert und hat keine Standard-Instanz als Rückfallebene. Sie spricht mit genau einem Host: der eingegebenen Adresse. layer418 betreibt in diesem Pfad keinen Dienst und erhält keine Requests aus der App.
Alle Daten liegen auf deinen Systemen
Spieler, Matches, Darts und Ratings speichert der Throwfather-Server, den du deployt hast — in der SQLite-Datei oder PostgreSQL-Datenbank, die du angebunden hast. Accounts, Namen, E-Mail-Adressen und Logins liegen in deinem eigenen Keycloak-Realm. All das sind Backends, die du selbst hostest, auf Infrastruktur deiner Wahl.
Was auf dem Gerät bleibt
Die Serveradresse in den App-Einstellungen, die OIDC-Tokens im Keystore der Plattform (iOS Keychain / Android Keystore) und beendete Matches, die offline auf den Upload warten. Abmelden löscht die Tokens, „Server wechseln“ auch die Adresse. Übertragen wird nichts davon irgendwohin außer an deinen Server und dein Realm.
Was dein Server speichert
Vier Tabellen: players, matches (mit den geworfenen Darts und der IP-Adresse des einreichenden Spielers), match_players und match_voids — dazu die Web-Login-Sessions. Ligaergebnisse, keine Personenprofile. Identitätsdaten (Name, E-Mail, Zugangsdaten) bleiben in Keycloak und werden nur über das Subject des Tokens referenziert.
Verantwortlich bist du
Wer die Instanz betreibt, ist dafür der Verantwortliche im Sinne der DSGVO und entscheidet über Aufbewahrung, Backups, Zugriff und Löschung. layer418 ist kein Auftragsverarbeiter deines Deployments und hat keinen Zugriff darauf. Hosten wir eine Instanz als bezahlte Leistung für dich, ist das ein separater Vertrag mit AVV.
# where data flows — and where it does not [ throwfather app ] │ │ HTTPS, bearer token ├──────────────▶ [ your throwfather-server ] ──▶ [ your database ] │ └──────────────▶ [ your Keycloak realm ] # login, identities ✕──────────────▶ [ layer418 ] # no connection, ever ✕──────────────▶ [ third parties ] # no SDKs, no analytics
Sendet die App irgendetwas an layer418?
Nein. In der App ist kein layer418-Endpunkt einkompiliert und kein Analytics- oder Crash-Reporting-SDK enthalten. Jeder Netzwerk-Request geht an die konfigurierte Serveradresse und an das Keycloak-Realm dieser Instanz.
Wer kann die Matches meiner Liga sehen?
Nur wem du in deinem Keycloak-Realm Zugriff gibst. Die Daten verlassen deinen Server und deine Datenbank nicht, die Zugriffskontrolle liegt also vollständig bei dir — inklusive vollständiger Löschung durch Verwerfen des Volumes oder der Datenbank.
Brauche ich Keycloak oder geht ein anderer Identity Provider?
Throwfather ist gegen Keycloak gebaut und getestet — der Server nutzt dessen azp-Claim für die App-Client-Prüfung und das Keycloak-OIDC-Preset für das Web-Interface. Andere OIDC-Provider sind ungetestet.
Kann layer418 das für uns hosten?
Ja — als Managed Deployment auf EU-Infrastruktur, inklusive Keycloak-Realm und Backups. Das ist gewöhnliches Hosting nach Vertrag; der Selbsthosting-Weg bleibt bestehen und kostet nichts.
Hilfe beim Deployment?
Selbst hosten ist der Punkt der Sache, und die Doku oben sollte reichen. Wenn wir es lieber betreiben sollen — oder es in ein bestehendes Keycloak-Realm gehört — schreib anhello@layer418.deund wir klären das.