VoySpeak Server 2.6.10 für Linux x86_64
==================================================

Voraussetzung: Linux x86_64 mit glibc 2.31 oder neuer, z. B. Debian 11+, Ubuntu 20.04+.
Eine Installation ist nicht nötig: Alle Bibliotheken außer denen des Grundsystems (glibc, libstdc++,
libgcc, zlib) liegen in libs/. Den Server nicht als root betreiben.


Ordner wählen und entpacken
---------------------------
Das Paket enthält keinen Oberordner, deshalb in einen eigenen Ordner entpacken, z. B.:
  sudo useradd --system --create-home --home-dir /opt/voyspeak --shell /usr/sbin/nologin voyspeak
  sudo tar -xzf VoySpeak-2.6.10-linux-amd64.tar.gz -C /opt/voyspeak
  sudo chown -R voyspeak:voyspeak /opt/voyspeak
Der Server arbeitet immer im eigenen Ordner (die Startskripte wechseln dorthin). Dort entstehen beim
ersten Start:
  config.yml (Standardwerte), TeaData.sqlite (Datenbank), logs/, files/ (Dateitransfer), certs/
Diese Dateien bei einem Update behalten (siehe unten).


Starten
-------
Im Vordergrund (erster Start):  ./teastart_minimal.sh
  Zugangsdaten und Log erscheinen im Terminal. Beim ersten Start zeigt der Server den Query-Login
  (serveradmin), das Passwort und den Privilege Key. Das Passwort sofort sichern: Es wird nur dieses
  eine Mal angezeigt. Beenden mit "shutdown" oder Strg+C.

Im Hintergrund:  ./teastart.sh start | stop | restart | status
  Die Ausgabe des Servers (beim ersten Start mit den Zugangsdaten) steht in logs/server_output.log.
  stop schickt SIGTERM und wartet bis zu 90 Sekunden.

Als Dienst (systemd, startet mit dem System und nach Abstürzen neu):
  voyspeak.service anpassen (Ordner, Benutzer), dann
  sudo cp voyspeak.service /etc/systemd/system/
  sudo systemctl daemon-reload
  sudo systemctl enable --now voyspeak
  journalctl -u voyspeak -f        (Ausgabe, beim ersten Start mit den Zugangsdaten)

Weitere Optionen: ./teastart_minimal.sh --help


Ports (Standard, änderbar in config.yml)
----------------------------------------
  9987/UDP          Voice (Clients)
  9987/TCP          Web-Client (gleiche Nummer wie der Voice-Port)
  10101/TCP         ServerQuery
  30303/TCP         Dateitransfer
  8180/TCP          Music-Webpanel (http://<Server-IP>:8180, Login mit den Query-Zugangsdaten)
  50000-56000/UDP   WebRTC (Audio im Web-Client)
Diese Ports in der Firewall freigeben, z. B. mit ufw:
  sudo ufw allow 9987/udp && sudo ufw allow 9987/tcp && sudo ufw allow 10101/tcp
  sudo ufw allow 30303/tcp && sudo ufw allow 8180/tcp && sudo ufw allow 50000:56000/udp


Lizenz
------
Den Lizenzschlüssel (GTS-...) als license.key neben die config.yml legen und den Server neu starten.


Music-Bots (YouTube, Radio, lokale Dateien)
-------------------------------------------
ffmpeg und yt-dlp sind nicht im Paket:
  sudo apt install ffmpeg
  sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
  sudo chmod a+rx /usr/local/bin/yt-dlp
providers/config_ffmpeg.ini ruft providers/bin/ffmpeg-system auf. Die Startskripte legen dort einen
kleinen Wrapper an, der das ffmpeg des Systems startet. Ein eigenes ffmpeg kann stattdessen unter
diesem Namen liegen. yt-dlp wird über PATH gefunden (providers/config_youtube.ini).


Update
------
Server stoppen, das neue Paket über den Ordner entpacken und den Server wieder starten. Datenbank,
config.yml, license.key, files/, certs/ und logs/ sind nicht im Paket und bleiben erhalten. Eigene
Änderungen an providers/*.ini bleiben mit --exclude erhalten:
  ./teastart.sh stop
  tar -xzf VoySpeak-<Version>-linux-amd64.tar.gz -C /opt/voyspeak --exclude='providers/*.ini'
  ./teastart.sh start
