Zum Hauptinhalt springen

Dein erstes Gerät

Voraussetzung

Diese Seite setzt einen Matrix-Homeserver (Synapse) voraus, den du oder jemand, dem du vertraust, betreibt, samt Administratorzugang dazu. Ohne einen solchen steht dir dieser Weg nicht offen – und nichts anderes in Lotti hängt davon ab.

Jedes Gerät nach dem ersten bekommt seinen Pairing-Code von einem Gerät, das du bereits nutzt — dieser Ablauf ist Gerät hinzufügen. Das erste ist anders: Es gibt kein anderes Gerät, das einen Code erzeugen könnte. Lottis Synchronisierung ist selbst gehostet, der erste Code kommt deshalb von der Serverseite — erstellt von der Person, die deinen Synapse-Homeserver betreibt.

Was das Provisionierungswerkzeug tut​

Lotti liefert ein Admin-CLI mit, den Matrix-Provisioner, im Repository unter tools/matrix_provisioner. Von einem Homeserver-Admin ausgeführt:

  1. erstellt es ein frisches Matrix-Konto nur für die Synchronisierung,
  2. erstellt den verschlüsselten Sync-Raum und
  3. schreibt ein Provisionierungs-Bundle — den Text, den Lotti als Pairing-Code akzeptiert — in eine Datei.

Das README neben dem Werkzeug dokumentiert die einmalige Einrichtung, jedes Argument und die sicheren Wege, das Admin-Passwort zu übergeben. Ein minimaler Aufruf sieht so aus:

cd tools/matrix_provisioner
python provision.py \
  --homeserver https://matrix.example.com \
  --admin-user admin \
  --username lotti_sync_user42 \
  --output-file bundle.txt

Wenn du keinen eigenen Homeserver betreibst, ist dieser Schritt nicht deiner — bitte die Person, die den Server betreibt, um das Bundle, und behandle den Weg, auf dem es dich erreicht, mit der unten beschriebenen Sorgfalt.

Das Bundle als ersten Pairing-Code verwenden​

Öffne auf dem Gerät, das dein erstes werden soll, Einstellungen → Synchronisierungseinstellungen → Geräte und wähle Sync einrichten. Füge den Text des Bundles in das Codefeld ein — auf dem Telefon, wo sich zuerst die Kamera öffnet, kommst du mit Code stattdessen einfügen dorthin. Prüfe, was der Code beschreibt, und verbinde — das ist für ein erstes Gerät bereits die ganze Reise. Eine Emoji-Verifizierung gibt es hier nicht: Sie vergleicht zwei deiner Geräte, und du hast erst eins. Die Zeremonie tritt zum ersten Mal auf, wenn du dein zweites Gerät über Gerät hinzufügen koppelst.

Ebenfalls wissenswert: Das Einlösen eines frischen Provisionierungs-Bundles rotiert das Kontopasswort beim Verbinden. Die Bundle-Datei ist nach dem ersten Gebrauch verbraucht — die gültigen Zugangsdaten existieren dann nur auf diesem Gerät, und jedes weitere Gerät koppelt sich über Gerät hinzufügen an ein vorhandenes. Lösche die Bundle-Datei, sobald das erste Gerät verbunden ist; eine liegengebliebene Kopie kann sich nicht mehr anmelden, aber es gibt keinen Grund, sie zu behalten.

Bis zu diesem ersten Gebrauch behandle das Bundle wie ein Passwort: Es meldet sich am Sync-Konto an — halte es aus Chats, Screenshots und geteilten Bildschirmen heraus.