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 — und wähle Weiter. Ein Bundle für das erste Gerät verbindet sofort: Es gibt keinen Prüfcode zu vergleichen, weil noch kein anderes Gerät einen anzeigt.

Alle Screenshots
Hier endet es für das erste Gerät. Alles, was du darauf schreibst, wartet auf das nächste Gerät, das du hinzufügst.
ScreenshotMobile Ansicht
Lottis Dialog Sync einrichten bestätigt, dass die Synchronisierung auf diesem Gerät eingerichtet ist, mit Zurück und Zu Geräte

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.

Unter Linux: anmelden ohne Bundle

Die Voraussetzung oben hat eine Ausnahme. Unter Linux bietet Sync einrichten zusätzlich Stattdessen mit einem Matrix-Konto anmelden an, und die Karte für das erste Gerät auf der Seite mit dem Pairing-Code trägt dieselbe Option. Gib die Serveradresse, deine vollständige Matrix-ID (etwa @name:example.com) und das Kontopasswort ein — Lotti meldet sich an, erstellt den verschlüsselten Sync-Raum in diesem Konto selbst und landet auf demselben Bildschirm für das erste Gerät, auf dem auch der Bundle-Weg endet. Kein Admin, kein Werkzeug, kein Bundle — jedes Matrix-Konto, das du kontrollierst, reicht, auf deinem eigenen Homeserver oder einem öffentlichen.

Zwei Dinge sind wissenswert. Nimm ein Konto, das nur für Sync da ist, keins, mit dem du chattest: Der Sync-Raum ist einfach ein weiterer Raum in diesem Konto, und alles, was du schreibst, landet darin. Und dein Passwort gehört hier dir — es bleibt im sicheren Speicher dieses Geräts und wird nie rotiert, anders als beim Bundle oben. Nur der Server, den du eingibst, sieht es — und die Pairing-Codes, die du später unter Gerät hinzufügen erstellst: Sie enthalten es, behandle sie also als die Zugangsdaten, die sie sind. Jedes weitere Gerät koppelt sich weiterhin über Gerät hinzufügen an dieses an.