🎛️ TS Control Panel

Setup-Anleitung

So richtest du das Panel auf deinem Webserver ein – in 5 Schritten.

Kurzfassung: Dateien hochladen → setup.php im Browser öffnen → DB-Daten eintragen → fertig. Der Assistent erstellt die config.php und legt alle Tabellen automatisch an. Du musst keine Datei von Hand schreiben.

1 Dateien hochladen

Den kompletten Ordner ts-control/ per FTP (FileZilla) auf den Webserver laden.

Erreichbar ist das Panel dann unter:

👉 https://deine-domain.de/ts-control/public/

Wenn möglich, den Domain-/Webroot direkt auf den Ordner public/ zeigen lassen – dann liegen config/, src/ und sql/ außerhalb des öffentlichen Bereichs (sicherer).

Wichtig: Lade keine fremde config/config.php mit hoch (z.B. eine lokale Testdatei). Sie zeigt sonst auf eine falsche Datenbank → Fehler 500. Falls schon passiert: Datei config/config.php auf dem Server löschen – oder einfach das Panel aufrufen, es leitet dich automatisch zum Setup.

2 Datenbank bereithalten

Im Hosting-Panel (z.B. KeyHelp) eine MySQL-Datenbank anlegen bzw. die Zugangsdaten bereitlegen:

Angabe	Beispiel
Host	`localhost`
Port	`3306`
Datenbankname	`dein_db_name`
Benutzer	`dein_db_user`
Passwort	•••••••

3 Setup-Assistent öffnen

Im Browser aufrufen:

👉 https://deine-domain.de/ts-control/public/setup.php

Im Formular eintragen und „Testen & Speichern" klicken:

die DB-Zugangsdaten aus Schritt 2
einen Panel-Admin Benutzer + Passwort (damit loggst du dich später ein)
Haken bei „DB-Schema importieren" lassen (legt die Tabellen an)

Der Assistent testet die Verbindung, importiert alle Tabellen und schreibt die config.php automatisch (inkl. Sicherheits-Schlüssel + gehashtem Passwort).

Falls die Meldung kommt, config/config.php sei nicht schreibbar: Der Assistent zeigt dann den fertigen Inhalt an – diesen einfach in eine neue Datei config/config.php kopieren (per FileZilla anlegen).

4 Einloggen

Nach „Fertig" auf „Zum Login →" klicken und mit dem in Schritt 3 gewählten Admin-Account anmelden. Du landest in der Server-Verwaltung – dort trägst du deine TeamSpeak-Server ein (Name, IP, Query-Port, Query-Login).

5 Setup absichern

setup.php nach der Einrichtung löschen oder per .htaccess sperren.
DB-Zugang später ändern: im Panel Sidebar → ⚙️ DB / Setup (nur eingeloggt).

TeamSpeak-Tipp (Channel-Manager): Damit das Panel die TS-Server steuern kann, muss der Query-Port (10011) erreichbar sein und die Server-IP des Webservers in der TS3-Datei query_ip_whitelist.txt stehen – sonst greift die ServerQuery-Flood-Sperre („Timeout"-Fehler).

❓ Häufige Probleme

Fehler 500 / „können diese Anforderung nicht verarbeiten"

Fremde/falsche config/config.php hochgeladen → löschen, Setup neu durchlaufen.
DB-Zugangsdaten falsch → setup.php öffnen, korrigieren.
Zu alte PHP-Version → im Hosting-Panel PHP 8.0+ (besser 8.1+) wählen.

„Timeout beim Lesen der Antwort" beim Channel-Laden → Query-Port nicht erreichbar oder Webserver-IP nicht in der query_ip_whitelist.

TS Control Panel · Setup-Anleitung · → Zum Setup