Vor der Installation
- Bereite einen Linux-Server, administrativen Zugang, eine Domain und DNS vor.
- Kläre Betreiber und Support-Kontakt; definiere Regeln für Registrierung und Datenverarbeitung.
- Richte SMTP oder ein autorisiertes Sibrel-Mail-Gateway ein. Die Registrierungsprüfung braucht funktionierende E-Mail.
- Wähle S3-kompatiblen Speicher: lokales MinIO oder ein externes Bucket.
- Wähle lokales oder separates LiveKit für Anrufe.
- Gebe die nötigen Ports in den Firewalls von Server und Anbieter frei.
Installation und Bereitschaft
Nutze den Verwaltungsassistenten in einer kompatiblen App- oder Panel-Version. Er fragt SSH-Zugang, E-Mail-, Speicher- und Medieneinstellungen ab. Erlaube ihm, nur dafür vorgesehene Maschinen zu ändern.
Teste nach der Installation GET /api/host/readiness, Registrierung mit E-Mail, Datei-Upload und -Download, einen Anruf zwischen zwei externen Netzen und eine Bot-Verbindung. Eine erfolgreiche HTTP-Antwort allein belegt keine Anrufqualität.
Proxy und Gateway
Der Reverse-Proxy muss den WebSocket-Upgrade für /api/bots/gateway und Client-Sockets weiterleiten. Logge den Token-Parameter nicht in Access-Logs. Erneuere Zertifikate automatisch und überwache ihren Ablauf.
Wähle LiveKit- und TURN-Ports passend zu deiner Konfiguration. Separate S3- und Medienknoten müssen von den relevanten Servern und Client-Netzen erreichbar sein.
Backups und Updates
- Sichere PostgreSQL, Objektspeicher, Konfiguration und Föderationsschlüssel an einem geschützten Ort.
- Lege Aufbewahrung und einen Backup-Plan fest; teste die Wiederherstellung regelmäßig auf einer separaten Maschine.
- Prüfe vor Updates Migrationen und Client-Kompatibilität und erstelle ein Backup.
- Updates auf über den Assistenten installierten Hosts können die App stoppen. Warne die Nutzenden vorher.
- Ein Datenbank-Backup während eines Updates bedeutet nicht, dass die Datenbank bei jedem Fehler automatisch zurückrollt.
- Schütze SSH, Dienstgeheimnisse und Backups vor unbefugtem Zugriff.
Dienste verschieben und Knoten ergänzen
Zusätzliche S3-Knoten verteilen neue Uploads, replizieren aber keine alten Dateien. Räume werden Medienknoten zugewiesen; das Entfernen eines Knotens aus der Konfiguration migriert bestehende Räume nicht.
Erhalte beim Ändern von Adressen und Buckets den Zugriff auf alte Objekte. Dateimigration, DNS-Änderungen und Außerbetriebnahme alter Maschinen sind getrennte Aufgaben. Ein Infrastruktur-Diagramm ist kein Beleg für eine erfolgreiche Migration.
Föderation und Regeln
Verbinde nur bekannte Hosts mit geprüften Schlüsseln. Überwache Versionskompatibilität, Netzwerkrouten und den Umgang mit Wiederholungen. Der Relay ist keine garantierte Warteschlange und verbessert Medien nicht automatisch.
Betreibende sind für ihre Hosts und die ihnen unterstellten Nutzenden verantwortlich. Lies die Regeln für Anlegen und Nutzung von Hosts und veröffentliche eigene Informationen zur Datenverarbeitung.
Registrierung und Zugang
Der Host-Administrator kann die öffentliche Registrierung schließen und Konten manuell im Admin-Bereich erstellen. Diese Einstellung gilt für den jeweiligen Host. Vor Abschluss eines Server-Updates Datenbankmigrationen anwenden, eine Sicherung behalten und die Anmeldung bestehender Nutzer prüfen.