Zum Inhalt springen
Taleward

Selbst betreiben

Für die Person, die sich um die Technik kümmert, im Verein oder in der privaten Runde. Programmieren musst du nicht. Ein Terminal nach Anleitung zu benutzen reicht.

Rechne mit einem Abend, davon viel Warten auf Downloads.

In fünf Schritten

  1. Server mieten oder einen eigenen Server wählen

    Für „Nur Cloud“ genügt ein kleiner gemieteter Linux-Server, zum Beispiel bei einem Anbieter in der EU. Soll alles bei euch bleiben, nehmt einen eigenen Server mit NVIDIA-Grafikkarte, im Verein oder zu Hause. Auf ihm läuft dann auch der Worker für die Transkription.

    Ihr braucht eine Domain oder Subdomain, die auf den Server zeigt, etwa taleward.euer-verein.de oder rpg.eure-domain.de.

  2. Installieren

    Melde dich per SSH auf dem Server an und führe diesen einen Befehl aus. Das Skript installiert Docker, falls es fehlt, und stellt drei Fragen: Domain, E-Mail für das Zertifikat und Name des Vereins.

    curl -fsSL https://raw.githubusercontent.com/Tinkerworkss/taleward-server/main/install.sh | sudo bash

    Danach läuft alles in Docker, HTTPS kommt automatisch über Caddy und Let’s Encrypt. Alle Geheimnisse erzeugt das Skript selbst.

  3. Einrichtungscode aus dem Protokoll öffnen

    Am Ende zeigt das Skript einen einmaligen Link. Nur wer ihn hat, kann den Server einrichten. So sieht er aus:

      Ersteinrichtung: im Browser öffnen
    https://taleward.euer-verein.de/verwaltung/einrichtung?code=K7Q2-M9XA

    Link verloren? Dieser Befehl zeigt ihn wieder an:

    cd /opt/taleward && sudo docker compose exec server chronik einrichtungscode

  4. Den Assistenten durchgehen

    Du legst deinen Verwalterzugang an. Danach führt ein Assistent durch alles Nötige. Jeder Schritt lässt sich überspringen, offene Punkte zeigt die Übersicht.

    1. Verein oder Runde
    2. Betriebsart: Nur Cloud, Lokaler Server oder beides
    3. Zusammenfassung
    4. Datenschutzhinweis, mit Vorlage
    5. Sicherung
    6. Erste Spielleitung

  5. Die SL einladen

    Die erste Spielleitung bekommt ihr Konto aus dem Assistenten. Sie legt in der App eine Kampagne an und lädt ihre Runde per Link oder QR-Code am Tisch ein. Ab hier braucht es dich nur noch für Updates.

Was ihr je Betriebsart braucht

  • Nur Cloud

    • Einen Linux-Server mit Docker
    • Eine Domain, die auf den Server zeigt
    • Einen Schlüssel von Mistral (EU) für Transkription und Zusammenfassung
    • Ein monatliches Kostenlimit, das du im Assistenten festlegst

  • Lokaler Server

    • Einen Server mit NVIDIA-Grafikkarte und aktuellem Treiber. Server und Worker können darauf gemeinsam laufen
    • Linux mit Docker oder Windows mit WSL2 und Docker
    • Einen Zugang bei Hugging Face für das Sprechermodell
    • Für Zugriff von außen eine Domain mit HTTPS

  • Lokaler Server, Cloud als Ausweichlösung

    • Alles aus „Lokaler Server“
    • Dazu einen Mistral-Schlüssel
    • Die Erlaubnis der SL je Kampagne, dass die Cloud einspringen darf

Der Worker

Der Worker wandelt die Aufnahmen mit der Grafikkarte in Text um. Reicht die Leistung des Servers, läuft er einfach auf demselben Server mit. Sonst kommt er auf einen zweiten Server mit Grafikkarte, zum Beispiel zu Hause oder im Verein. In der Verwaltung unter „Transkription → Weiteren Worker anbinden“ bekommst du einen Kopplungscode. Auf dem Server, auf dem der Worker laufen soll:

sudo docker run -d --gpus all --restart unless-stopped --name taleward-worker ghcr.io/Tinkerworkss/taleward-worker:latest --koppeln ABCD-EFGH --server https://taleward.euer-verein.de

Der Worker holt sich Schlüssel und Adresse selbst. Pausieren, zum Beispiel während ihr spielt, geht in der Verwaltung.

Im laufenden Betrieb

Jede Nacht sichert der Server Datenbank, Bilder und Unterlagen. Die letzten 14 Tage bleiben erhalten. Wiederherstellen geht in der Verwaltung.

Ist eine neue Version da, reicht dieser Befehl:

cd /opt/taleward && sudo docker compose pull && sudo docker compose up -d

Und die Daten?

Mit eigenem Server seid ihr Verantwortliche im Sinne der DSGVO. Der Server hilft dabei: Er bringt eine Vorlage für euren Datenschutzhinweis mit und eine Liste, mit welchen Anbietern ihr eine Auftragsverarbeitung abschließen müsst. Rechtsberatung ersetzt das nicht.

Die ganze Anleitung

Jeder Schritt mit Kontrollpunkten und einer Tabelle für den Fall, dass etwas nicht klappt, steht in der Installationsanleitung im Repository.

Installationsanleitung öffnen