Direkt zum Hauptinhalt

CONNECT_NOT_PAIRED

Dieser Fehler bedeutet: Chatlix Connect läuft auf deinem Rechner, hat aber kein gültiges Pairing mit deinem Chatlix-Workspace. Ohne Pairing kann Connect keine OBS-Befehle entgegennehmen, keine Entitlements (Pro-Features) beziehen und keine Bridge-Aktionen (Lichter, Replay, Game-Watcher) ausführen.

Wie Pairing technisch funktioniert

Anders als man vermuten könnte, ist das kein einfacher "eingeloggt/nicht eingeloggt"-Schalter. Chatlix Connect pairt sich über ein Public-Key-Verfahren (Ed25519) mit deinem Account:

  1. Du hinterlegst deinen Chatlix-API-Token aus dem Dashboard einmalig in der Connect-App.
  2. Connect erzeugt lokal ein Schlüsselpaar und fordert beim Server einen Pairing-Nonce an (gültig 10 Minuten, in connect_pairing_nonces gespeichert).
  3. Connect signiert den Nonce mit seinem privaten Schlüssel und schickt den Beweis zurück.
  4. Der Server prüft die Signatur, verknüpft den Public Key mit deinem Account/deiner Bridge und stellt ein Entitlement aus.

Dieses Entitlement ist 6 Stunden hart gültig, plus 48 Stunden Kulanz (insgesamt bis zu 54 Stunden), falls dein Rechner mal offline ist — Connect muss also nicht bei jedem Neustart neu pairen, solange du regelmäßig online bist.

Die tatsächlichen Fehlercodes

Im Log/Response siehst du statt eines pauschalen CONNECT_NOT_PAIRED einen spezifischeren code. Die wichtigsten:

  • bridge_not_found — es existiert noch keine Bridge-Registrierung für dieses Gerät. Normalfall bei der Erstinstallation.
  • bridge_revoked — die Bridge wurde entfernt (z.B. weil du sie im Dashboard unter „Verbundene Geräte“ gelöscht hast).
  • device_public_key_required / device_public_key_missing — Connect hat noch keinen lokalen Schlüssel erzeugt oder konnte ihn nicht übertragen. Meist ein Zeichen, dass die lokale Config-Datei beschädigt oder von Rechten her nicht lesbar ist.
  • public_key_conflict (HTTP 409) — dein Account hat schon einen anderen Public Key für diese Bridge hinterlegt (z.B. weil du Connect auf einem anderen PC neu installiert hast, ohne die alte Bridge zu entfernen). Hier reicht ein einfaches Re-Pairing nicht: du musst zuerst die alte Bridge im Dashboard revoken.
  • nonce_not_found, nonce_expired, nonce_replay, nonce_value_mismatch, nonce_owner_mismatch — der Pairing-Nonce ist ungültig geworden. Häufigste Ursache: mehr als 10 Minuten zwischen Anfordern und Abschließen des Pairings verstreichen lassen, oder ein zweiter Pairing-Versuch mit demselben (bereits verbrauchten) Nonce.
  • invalid_signature, invalid_signature_length, invalid_signature_encoding — die Signatur passt nicht zum hinterlegten Public Key. Tritt praktisch nur auf, wenn die lokale Schlüssel-Datei manuell verändert oder zwischen zwei Connect-Installationen kopiert wurde.
  • bridge_user_mismatch — die Bridge gehört nachweislich einem anderen Chatlix-Account als dem, mit dessen Token du gerade pairst.

Lösung

  1. Chatlix-Connect-App öffnen, prüfen ob überhaupt ein API-Token hinterlegt ist (Einstellungen → Verbindung).
  2. Frischen Token unter /dashboard/tokens generieren, in Connect einfügen — das stößt automatisch einen neuen Pairing-Versuch mit frischem Nonce an.
  3. Bei public_key_conflict: im Dashboard unter „Verbundene Geräte“ die alte Bridge entfernen (revoken), danach erneut pairen.
  4. Bei wiederholtem nonce_expired: Systemzeit deines Rechners prüfen — eine falsch gestellte Uhr lässt den Nonce serverseitig sofort als abgelaufen erscheinen.
  5. Wenn gar nichts greift: Connect komplett beenden, Config-Ordner (~/.config/chatlix-connect/ unter Linux, %APPDATA%\Chatlix\Connect\ unter Windows) umbenennen (nicht löschen, falls Rollback nötig) und Connect neu starten — das erzwingt ein sauberes Neu-Pairing mit frischem Schlüsselpaar.

Abgrenzung zu OBS_NOT_REACHABLE

CONNECT_NOT_PAIRED heißt: die Bridge zwischen deinem Rechner und Chatlix-Cloud fehlt komplett. Ist die Bridge gepairt, aber OBS selbst antwortet nicht, landest du stattdessen bei OBS_NOT_REACHABLE — das ist ein Problem eine Ebene weiter oben in der Kette (Connect ↔ OBS, nicht Connect ↔ Chatlix).