Installation mit Docker Compose
Der Einrichtungsassistent schreibt eine vollständige, lauffähige Konfiguration mit allen erzeugten Geheimnissen. Du startest sie, setzt HTTPS davor, öffnest die Ports und prüfst dann jede Schicht von außen nach innen.
Schritt 1: Dateien erzeugen
Starte den Einrichtungsassistenten in einem leeren Ordner:
mkdir mnema-talk && cd mnema-talkdocker run --rm -it --user "$(id -u):$(id -g)" \
-v "$PWD:/out" ghcr.io/mnema-xyz/mnema-talk setup
-it erlaubt dem Assistenten, dir Fragen zu stellen, --user sorgt dafür, dass die Dateien dir gehören statt root, und -v ist der Ordner, in den er schreibt. Du musst nichts klonen und nichts bauen.
Er fragt nach der Adresse, die Mitglieder öffnen (zum Beispiel https://chat.example.com), dem Benutzernamen des Owners (Standard admin), der Sprache der vorgegebenen Kanalnamen und optional nach der Adresse dieses Rechners in deinem Netz, nach Mail-Einstellungen und dem Knopf für Updates mit einem Klick. Dann prüft er, was er von dort aus sehen kann: ob der Name auf die öffentliche Adresse dieses Netzes zeigt, die Uhrzeit und ob der Anschluss hinter CGNAT hängt. Am Ende steht eine nummerierte Liste mit den nächsten Schritten.
Eine vorhandene .env überschreibt er nie: Neue Geheimnisse würden nicht zu einer bestehenden Datenbank passen.
Ohne Terminal-Sitzung
Für Skripte oder die Weboberfläche eines NAS gibst du alles als Optionen mit. setup --help listet sie alle auf, darunter --local zum Ausprobieren, --lan-ip, die --smtp-*-Einstellungen, --auto-update und --check, das nur die Einstellungen auflistet, die fehlen oder noch Platzhalter sind.
docker run --rm --user "$(id -u):$(id -g)" -v "$PWD:/out" \
ghcr.io/mnema-xyz/mnema-talk setup --non-interactive \
--public-url https://chat.example.com --admin-username admin --language en
Schritt 2: Starten
docker compose up -d --waitcurl -fsS http://127.0.0.1:8080/api/health
Der erste Start lädt die Images herunter, das dauert ein paar Minuten. Antwortet die Statusabfrage mit "status":"ok", läuft die App. Von außen erreicht sie noch niemand: Der App-Port lauscht nur auf dem Rechner selbst, der einzige Weg hinein führt also über deinen Reverse Proxy.
Der Stack besteht aus drei Containern: mnema-talk (die App), PostgreSQL und SeaweedFS. Optionale Teile starten nur, wenn du ihr Compose-Profil einschaltest: autoupdate für den Update-now-Knopf und turn für ein externes coturn-Relay.
Schritt 3: HTTPS davor
Lass den DNS-Eintrag auf deinen Server zeigen und richte den Reverse Proxy ein: Domain, DNS und TLS. Sobald https://chat.example.com die Anmeldeseite zeigt, ist der Web-Teil fertig.
Schritt 4: Ports öffnen
Für Sprache brauchst du neben HTTPS zwei weitere Regeln: UDP 50000–50050 und 3479 über UDP und TCP. Ports und Firewall hat die Tabelle; zu Hause zeigt Hinter dem Router die Schritte für die Weiterleitung.
Schritt 5: Schicht für Schicht prüfen
Teste in dieser Reihenfolge und halte beim ersten Fehler an; eine kaputte Schicht lässt alles danach kaputt aussehen.
- Die Seite. Öffne deine Adresse auf dem Handy mit ausgeschaltetem WLAN. Du solltest ein Schloss und die Anmeldeseite sehen.
- Live-Updates. Melde dich als Owner an. Die Seite sollte benutzbar bleiben und nie „Connection lost“ zeigen.
- Admin console > Status. Warte nach einem Start etwa zwanzig Sekunden. Jeder gelbe oder rote Punkt nennt die Einstellung, die du ändern musst.
- Test my connection. Der Knopf unter Admin > Status läuft in deinem Browser, braucht kein Mikrofon und sagt dir, ob direktes UDP klappt, nur das Relay oder gar nichts. Probier es von außerhalb deines Heimnetzes. Im Terminal zeigt
docker compose exec app mnema-talk doctordieselben Prüfungen aus Sicht des Servers. - Ein echtes Gespräch. Erstelle eine Einladung, öffne sie auf dem Handy im Mobilfunknetz, tritt am Rechner einem Talk bei und sprich. Innerhalb von etwa zwei Sekunden solltet ihr euch hören.
Klappt ein Schritt nicht, geht die Fehlersuche Ursachen und Lösungen in derselben Reihenfolge durch.
Schritt 6: Die erste Anmeldung
Melde dich mit dem Benutzernamen des Owners und dem Passwort an, das der Assistent ausgegeben hat. Ändere das Passwort und lösche danach die Zeile ADMIN_INITIAL_PASSWORD aus der .env; sie legt das Konto nur beim allerersten Start an. Was du als Nächstes einrichtest: Erste Schritte als Owner.
Probier es auf einem Rechner aus
Du willst dich umsehen, bevor du eine Domain kaufst? Beantworte in Schritt 1 die Frage „Just try it on this computer?“ mit Ja, oder starte setup --local. Starte danach den Stack, öffne http://localhost:8080 und melde dich an. Zwei Browser-Tabs mit zwei Konten können gemeinsam einem Talk beitreten.
Reines http:// funktioniert nur auf localhost: Auf jeder anderen http://-Adresse sperren Browser Mikrofon und Kamera, du kannst dann lesen und schreiben, aber nicht sprechen. Docker Desktop unter Windows oder macOS reicht für diesen Test, ist aber kein getestetes Ziel für den echten Betrieb.
Ohne den Assistenten
Die Compose-Datei und die .env.example eines Releases sind das ganze Deployment. Die manuellen Schritte, jede nötige Variable und wie du eine Version festnagelst, steht unter Deployment im Repository. Die CI führt genau diese Schritte gegen jedes Image aus, das sie baut.