Account anlegen

Wichtig, bevor du anfaengst: Die freie Selbstregistrierung per Email/Passwort ist aktuell geschlossen. Ein Klick auf „Registrieren" ohne Invite liefert vom Backend einen 403 mit dem Code invite_only zurueck. Du brauchst also entweder einen Invite-Code oder du meldest dich per Google/Twitch mit einem Invite-Code an. Wenn du keinen hast, ist der Weg ueber die Warteliste oder eine Mail an [email protected].

Variante 1: Invite-Code + Email/Passwort

1. Oeffne chatlix.app und klicke auf « Registrieren ».
2. Trage deinen Invite-Code, Email, Passwort und Passwort-Wiederholung ein.
3. Bestaetigen. Der Code wird einmalig eingeloest (ein Code = ein Account).
4. Nach erfolgreichem Abschluss landest du im Dashboard unter /dashboard/.

Unter der Haube laeuft das gegen die Route /auth/invite/register (POST). Das ist seit „Auth V2 Phase 5" der einzige legitime Weg, einen komplett neuen Account per Email/Passwort anzulegen. Typische Fehlercodes vom Server: invite_already_claimed, email_taken, email_mismatch, provider_collision, password_mismatch. Es gibt zusaetzlich Rate-Limits pro IP, pro Email-Hash und pro Code-Hash — wer den Code mehrfach falsch eingibt, wird kurzzeitig gebremst.

Variante 2: OAuth mit Invite-Code (neue Nutzer)

Du kannst dich direkt mit Google oder Twitch registrieren, wenn du noch keinen Chatlix-Account hast. In dem Fall ist der Invite-Code Pflicht.

• Google: Button « Mit Google anmelden », Route /oauth/google/login → /oauth/google/callback
• Twitch: Button « Mit Twitch anmelden », Route /oauth/twitch/login → /oauth/twitch/callback

Ohne Invite-Code bricht der Flow ab: Google leitet dich mit ?google_error=invite_required zurueck aufs Dashboard, bei Twitch bekommst du eine vergleichbare Fehlermeldung. Existiert bereits eine verknuepfte Google- oder Twitch-Identitaet (du hast dich also schon mal so angemeldet), wird stattdessen direkt eingeloggt, ganz ohne Invite-Code noetig — das ist dann kein Registrierungs-, sondern ein Login-Vorgang.

Beim Twitch-OAuth bekommt Chatlix zugleich die Scopes, die der Bot fuer Chat, Moderation, Redemptions und Events braucht (siehe „Wichtige Konzepte" fuer die volle Liste). Bist du schon eingeloggt und verbindest Twitch nur nachtraeglich (Modus „link" statt „auth"), ist kein Invite-Code noetig — das ist der Normalfall aus „Erstes Setup in 5 Minuten".

Wo bekomme ich einen Invite-Code her?

• Von einem bestehenden Chatlix-Nutzer ueber dessen Referral-Link (Dashboard-Menuepunkt „Referral" unter „Content produzieren"). Der Nutzer sieht dort seinen Link und Stats zu eingeloesten Codes.
• Vom Chatlix-Team direkt, z. B. nach Anfrage an [email protected].
• Ueber die Warteliste (/api/waitlist, POST): Email eintragen, per Mail-Link bestaetigen (/api/waitlist/confirm). Sobald ein Platz frei ist, bekommst du eine Einladungsmail mit Code.

Login fuer bestehende Accounts

Email + Passwort

Normaler Login gegen /auth/login (POST). Nach zu vielen Fehlversuchen greift der Rate-Limiter.

Magic-Link

Kein Passwort, nur ein einmaliger Login-Link per Mail — funktioniert nur fuer bereits existierende Accounts, nicht als Registrierungsweg.

1. Auf der Login-Seite « Magic-Link senden » waehlen.
2. Email eintragen, reCAPTCHA loesen.
3. Mail oeffnen, Link klicken.

Anfordern laeuft ueber /auth/magic-request (POST), Einloesen ueber /auth/magic (GET, per Token in der URL). Magic-Links laufen nach kurzer Zeit ab und sind an ein JWT gebunden. Klickst du einen alten/verbrauchten Link, siehst du eine eigene Fehlerseite mit Link „Neu anfordern". Wenn du keine Mail erhaeltst: Spam-Ordner pruefen, Adresse erneut eingeben.

MFA aktivieren

Nach dem ersten Login solltest du MFA einschalten. Menuepfad: „System & Konto" → „Konto & Plan" → Sicherheit.

1. « TOTP aktivieren » waehlen — Route /auth/mfa/totp/setup.
2. QR-Code mit deiner Authenticator-App scannen (Aegis, Authy, 1Password, etc.).
3. Sechsstelligen Code eingeben und bestaetigen — Route /auth/mfa/totp/confirm.
4. Recovery-Codes herunterladen und sicher ablegen (nicht im selben Passwort-Tresor wie den TOTP-Seed, sonst ist ein zweiter Faktor wertlos). Neu erzeugen kannst du sie jederzeit ueber /auth/mfa/recovery-codes/regenerate — die alten werden dabei ungueltig.

Der Login mit zweitem Faktor laeuft ueber /auth/mfa/verify — das ist bewusst der einzige Auth-Endpunkt, der ganz ohne bestehende Session funktioniert (du bist ja mitten im Login). Deaktivieren geht ueber /auth/mfa/totp/disable. Ohne Recovery-Codes bist du bei Geraeteverlust ausgesperrt und brauchst Support.

Onboarding nach dem ersten Login

Nach dem allerersten Login landest du entweder direkt im gamifizierten Einstieg unter /dashboard/onboarding (sieben Schritte: Intro, Game-Watcher-Download, Twitch verbinden, Heartbeat-Demo, Demo-Event abspielen, Magic-Moments-Overlay-Test, Abschluss) oder im praktischen Setup-Wizard unter /dashboard/wizard, der dich wirklich live bringt. Beide sind jederzeit unterbrechbar und ueber die Sidebar wieder erreichbar. Details zum Wizard-Flow stehen in „Erstes Setup in 5 Minuten".

Probleme