TeamSpeak-Server auf dem Raspberry Pi: Pi mit Headset und Netzwerk-Switch

TeamSpeak 6 Server auf dem Raspberry Pi installieren

Einen eigenen TeamSpeak-Server auf dem Raspberry Pi betreibt ihr heute mit dem TeamSpeak-6-Server. TeamSpeak bietet ihn offiziell für ARM64 an, also für den Pi mit 64-Bit-System. Damit habt ihr einen Voice-Server für Freunde, Gilde oder Verein, der rund um die Uhr läuft, ohne gemieteten Server und ohne Abo.

Hier richtet ihr den Server mit Docker Compose ein, verbindet euch als Admin, macht ihn von außen erreichbar und haltet ihn aktuell. Wer kein Docker nutzen will, findet weiter unten den Weg mit dem Programmpaket und systemd. Alle Befehle haben wir im Oktober 2026 auf einem Raspberry Pi 5 mit Raspberry Pi OS (64-bit) und der Server-Version 6.0.0-beta13.1 geprüft.

Kurz gesagt

Auf dem Raspberry Pi läuft nur der TeamSpeak-6-Server. Am einfachsten startet ihr ihn mit dem offiziellen Docker-Image, denn so sind auch Updates mit zwei Befehlen erledigt.

  • Ihr braucht: einen Raspberry Pi mit Raspberry Pi OS in der 64-bit-Version, für den empfohlenen Weg dazu Docker.
  • Kosten: Der Server ist kostenlos für einen virtuellen Server mit 32 Plätzen.
  • Vorab wichtig: Der TeamSpeak-6-Server ist noch eine Beta. Seine Lizenz steckt in der Server-Version und läuft regelmäßig ab. Ohne Update startet er danach nicht mehr.
  • TeamSpeak 3: Den alten TS3-Server gibt es nicht für den Pi. Mit dem TS3-Client (ab Version 3.6.0) könnt ihr euch aber auf den neuen Server verbinden.

TeamSpeak 3 oder 6: was läuft auf dem Pi?

Den TeamSpeak-3-Server bietet TeamSpeak nur für PCs mit Intel- oder AMD-Prozessor an (x86 und amd64), dazu für Windows, macOS und FreeBSD. Eine Version für ARM-Prozessoren wie den des Raspberry Pi gibt es nicht: Auch die aktuelle Version 3.13.8 steht nur für x86 und amd64 zum Download. Auch das offizielle Docker-Image für TS3 gibt es nur für amd64. Anleitungen, die einen TS3-Server „nativ für ARM64“ herunterladen, funktionieren deshalb nicht.

Der TeamSpeak-6-Server ist der Nachfolger und erscheint offiziell auch für Linux auf ARM64, als Programmpaket und als Docker-Image. Er hat drei Eigenheiten, die ihr vor dem Einrichten kennen solltet:

  • Er ist eine Beta. TeamSpeak entwickelt ihn noch weiter, einzelne Funktionen können sich ändern.
  • Die Lizenz läuft mit der Version ab. Jede Server-Version bringt eine kostenlose Lizenz für einen virtuellen Server mit 32 Plätzen mit, aber nur für einen festen Zeitraum. Bei Version 6.0.0-beta13.1 endet sie am 1. Dezember 2026. Ist das Datum erreicht, bricht der Server beim Start mit „The default license has expired“ ab. TeamSpeak verlängert die Lizenz mit neuen Versionen. Wie ihr aktualisiert, steht im Abschnitt Server aktuell halten.
  • Kein Umzug von TS3. Einen bestehenden TS3-Server mit Channels und Rechten könnt ihr nicht übernehmen, und TS3-Lizenzen gelten für TS6 nicht. Größere Lizenzen als 32 Plätze gibt es für den TS6-Server noch nicht.

Für den Freundeskreis passt das gut: TS6-Clients und TS3-Clients ab Version 3.6.0 verbinden sich laut TeamSpeak mit demselben Server. Wer dagegen seinen TS3-Server mit allen Einstellungen behalten will, braucht dafür einen Rechner mit x86-Prozessor, etwa einen Mini-PC.

Was ihr braucht

Mit * markierte Links sind Affiliate-Links, also Werbung. Kauft ihr darüber ein, erhalte ich eine Provision, der Preis bleibt für euch gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

Ob euer System 64-bit ist, prüft ihr im Terminal:

uname -m

Steht dort aarch64, passt alles. Bei armv7l läuft ein 32-Bit-System, auf dem der Server nicht startet. Dann spielt ihr Raspberry Pi OS (64-bit) neu auf, zum Beispiel mit dem Raspberry Pi Imager.

Docker oder ohne Docker?

Für den Server gibt es zwei Wege. Mit Docker richtet ihr ihn mit einer Datei ein, und ein Update braucht zwei Befehle. Das empfehlen wir, weil ihr wegen der Beta-Lizenz regelmäßig aktualisieren müsst. Ohne Docker installiert ihr das Programmpaket direkt als systemd-Dienst. Das spart euch Docker, dafür ist jedes Update etwas mehr Handarbeit. Diesen Weg findet ihr unter Ohne Docker: TeamSpeak-Server als systemd-Dienst.

TeamSpeak-Server mit Docker Compose starten

Legt zuerst einen Ordner für den Server an und wechselt hinein:

mkdir -p ~/teamspeak
cd ~/teamspeak

Darin erstellt ihr die Datei compose.yaml:

nano compose.yaml

Fügt diesen Inhalt ein:

services:
  teamspeak:
    image: teamspeaksystems/teamspeak6-server:latest
    container_name: teamspeak-server
    restart: unless-stopped
    ports:
      - "9987:9987/udp"
      - "30033:30033/tcp"
    environment:
      - TSSERVER_LICENSE_ACCEPTED=accept
    volumes:
      - teamspeak-data:/var/tsserver

volumes:
  teamspeak-data:

Speichert mit Strg+O und Enter, beendet nano mit Strg+X. Die Zeilen bedeuten:

  • image: das offizielle Image von TeamSpeak. latest ist immer die neueste Version, Docker lädt automatisch die ARM64-Variante.
  • restart: unless-stopped: Der Server startet nach einem Neustart des Pi von selbst, außer ihr habt ihn vorher gestoppt.
  • ports: 9987/UDP ist der Sprachkanal, 30033/TCP die Dateiübertragung, etwa für Avatare und Dateien in Channels.
  • TSSERVER_LICENSE_ACCEPTED=accept: Damit akzeptiert ihr die Lizenzbedingungen von TeamSpeak. Ohne diese Zeile startet der Server nicht.
  • volumes: Datenbank, Logs und hochgeladene Dateien liegen im Volume teamspeak-data. Es bleibt erhalten, wenn ihr den Container aktualisiert oder neu erstellt.

Startet den Server:

docker compose up -d

Docker lädt das Image und startet den Container. Ob er läuft, zeigt:

docker compose ps

In der Spalte STATUS sollte Up stehen. Steht dort Restarting oder Exited, zeigt docker compose logs den Grund, zum Beispiel einen Tippfehler in der Zeile mit der Lizenz.

Admin-Token sichern

Beim allerersten Start legt der Server zwei Zugänge an und schreibt sie ins Log: einen Token (Berechtigungsschlüssel), mit dem ihr euch im Client zum Server-Admin macht, und das Passwort für den Admin-Zugang der ServerQuery. Das ist eine Schnittstelle für Bots und Verwaltungstools. Sie ist ab Werk ausgeschaltet, das Passwort braucht ihr erst, wenn ihr sie später einschaltet. Holt beides aus dem Log:

docker compose logs | grep -E "token=|loginname"

Ihr seht Zeilen wie token=jkGZy2zk… und loginname= "serveradmin", password= "…". Kopiert den Teil nach token= und das Passwort in euren Passwortmanager.

Wichtig: Der Server gibt Token und Passwort nur beim ersten Start aus. Nach dem ersten Update erstellt Docker einen neuen Container mit leerem Log, dann zeigt docker compose logs beides nicht mehr an. Löst den Token deshalb gleich im nächsten Schritt ein. Sonst müsst ihr ihn aus den Logdateien im Volume suchen.

So findet ihr ihn dort:

docker compose exec teamspeak grep -rh "token=" /var/tsserver/logs/

Mit dem Client verbinden und Admin werden

Ladet den TeamSpeak-Client von der Download-Seite von TeamSpeak herunter. Dort gibt es den TeamSpeak-6-Client für Windows, macOS und Linux und weiter den TeamSpeak-3-Client. Beide funktionieren, beim TS3-Client braucht ihr mindestens Version 3.6.0.

Die Schritte zeigen wir mit dem TeamSpeak-6-Client:

  1. Tippt die IP-Adresse eures Pi auf der Startseite des Clients in das Suchfeld unter Beliebte Server, zum Beispiel 192.168.178.50, und klickt darunter unter Schnelles Verbinden auf den Eintrag. Den Standard-Port 9987 müsst ihr nicht angeben, ein Passwort hat der Server noch nicht.
  2. Weil der Server noch keinen Besitzer hat, blendet der Client oben die Frage „Ist dies dein TeamSpeak-Server?“ ein. Fügt dort den Token ein, also alles nach token=, und klickt auf Anwenden. Danach gehört ihr zur Gruppe „Server Admin“.
TeamSpeak-6-Client: IP-Adresse im Suchfeld unter Beliebte Server, darunter Schnelles Verbinden
IP-Adresse ins Suchfeld eintippen und unter „Schnelles Verbinden“ anklicken.
TeamSpeak-6-Client fragt „Ist dies dein TeamSpeak-Server?“ mit Feld für den Berechtigungsschlüssel
Beim ersten Verbinden fragt der Client nach dem Token.

Als Admin legt ihr Channels an, vergebt Rechte und setzt vor allem ein Server-Passwort. Das solltet ihr tun, bevor ihr den Server aus dem Internet erreichbar macht:

  1. Klickt rechts neben dem Servernamen auf das Stift-Symbol Servereinstellungen bearbeiten.
  2. Unter Allgemein tragt ihr einen Namen und das Passwort ein. Darunter seht ihr das Benutzerlimit mit den 32 Plätzen der kostenlosen Lizenz.
  3. Speichert mit Optionen speichern.
Server-Ansicht im TeamSpeak-6-Client mit markiertem Stift-Symbol Servereinstellungen bearbeiten
Über das Stift-Symbol öffnet ihr die Servereinstellungen.
Servereinstellungen im TeamSpeak-6-Client: Name, Passwort und Benutzerlimit 32
Passwort eintragen und mit „Optionen speichern“ übernehmen.

Eure Mitspieler geben beim Verbinden dann die Adresse des Servers und dieses Passwort ein.

Server aus dem Internet erreichbar machen

Im Heimnetz läuft der Server jetzt. Damit sich Freunde von außen verbinden können, leitet ihr im Router Ports an die IP-Adresse des Pi weiter:

PortProtokollWofürFreigeben?
9987UDPSpracheJa, Pflicht
30033TCPDateiübertragung (Avatare, Dateien)Ja, wenn ihr Dateien nutzt
10022, 10080TCPServerQuery (SSH, HTTP)Nein, nie ins Internet

Die ServerQuery ist beim TeamSpeak-6-Server ab Werk ausgeschaltet, deshalb fehlen ihre Ports auch in der compose.yaml. Lasst sie ausgeschaltet, solange ihr sie nicht braucht, und gebt ihre Ports auch später nicht im Router frei. Wie die Weiterleitung im Router funktioniert, zeigt Port Forwarding einrichten.

Eure öffentliche IP-Adresse ändert sich bei den meisten Anschlüssen regelmäßig. Ein DynDNS-Dienst wie DuckDNS gibt dem Server einen festen Namen, zum Beispiel meinserver.duckdns.org: DynDNS mit dem Raspberry Pi einrichten.

Vorsicht bei DS-Lite: Viele Kabel- und Glasfaseranschlüsse haben keine eigene öffentliche IPv4-Adresse mehr, sondern teilen sie sich mit anderen Kunden. Eine Portfreigabe für IPv4 läuft dann ins Leere. Ob euer Anschluss betroffen ist, seht ihr meist in der Übersicht des Routers. In diesem Fall erreicht ihr den Server nur über IPv6, wenn alle Mitspieler IPv6 haben, oder über ein VPN. Für eine feste Runde ist das VPN aus dem folgenden Kasten meist der einfachere Weg.

Alternative ohne Portfreigabe: VPN
Mit einem VPN wie Tailscale öffnet ihr keinen Port im Router. Dafür braucht jeder Mitspieler die Tailscale-App und eine Einladung in euer Netz. Für eine feste kleine Runde funktioniert das gut, für offene Server nicht. Mehr dazu in Raspberry Pi absichern.

Server aktuell halten und Lizenz erneuern

Weil die Lizenz in der Server-Version steckt, gehören Updates beim TeamSpeak-6-Server zum Betrieb. Bis wann eure Version läuft, steht im Log, etwa als ending date : Tue Dec 1 00:00:00 2026:

docker compose logs | grep "ending date"

Ist das Datum erreicht, startet der Server nicht mehr. Docker versucht es dann wegen restart: unless-stopped immer wieder, und im Log steht „The default license has expired. Please use the latest server version.“. Aktualisiert deshalb rechtzeitig vorher:

cd ~/teamspeak
docker compose pull
docker compose up -d

pull lädt die neueste Version, up -d ersetzt den Container. Channels, Rechte und euer Admin-Status bleiben erhalten, weil sie im Volume liegen. Einen neuen Token gibt es dabei nicht. Ohne Docker sieht das Update anders aus, die Befehle stehen am Ende des Abschnitts ohne Docker. Neue Versionen erfahrt ihr am einfachsten auf GitHub: Auf der Release-Seite des TeamSpeak-6-Servers könnt ihr mit Watch → Custom → Releases eine Benachrichtigung einschalten.

Automatische Updates per Watchtower oder ähnlichen Tools empfehlen wir bei einer Beta nicht. Aktualisiert lieber selbst, wenn ihr Zeit habt, nach dem Update kurz nachzusehen, ob alles läuft.

Ohne Docker: TeamSpeak-Server als systemd-Dienst

Ihr wollt kein Docker auf dem Pi? Dann installiert ihr das Programmpaket direkt und startet es als systemd-Dienst. Der Server läuft unter einem eigenen Systembenutzer ohne Root-Rechte. Legt den Benutzer und den Programmordner an:

sudo adduser --system --group --home /opt/teamspeak teamspeak
sudo mkdir -p /opt/teamspeak/server

Ladet die neueste Version für ARM64 von GitHub und entpackt sie. Das Archiv enthält keinen eigenen Unterordner, deshalb gebt ihr das Ziel mit -C an:

cd /tmp
curl -LO https://github.com/teamspeak/teamspeak6-server/releases/latest/download/teamspeak6-server-linux-arm64.tar.xz
sudo tar -xJf teamspeak6-server-linux-arm64.tar.xz -C /opt/teamspeak/server
sudo chown -R teamspeak:teamspeak /opt/teamspeak/server

Legt die Dienst-Datei an, fügt den folgenden Inhalt ein und speichert:

sudo nano /etc/systemd/system/teamspeak.service
[Unit]
Description=TeamSpeak 6 Server
After=network-online.target
Wants=network-online.target

[Service]
User=teamspeak
Group=teamspeak
WorkingDirectory=/opt/teamspeak/server
ExecStart=/opt/teamspeak/server/tsserver --accept-license
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

--accept-license bestätigt die Lizenzbedingungen. Aktiviert und startet den Dienst, dann holt ihr Token und ServerQuery-Passwort aus dem Journal:

sudo systemctl daemon-reload
sudo systemctl enable --now teamspeak
sudo journalctl -u teamspeak | grep -E "token=|loginname"

Ab hier geht es weiter wie beim Verbinden mit dem Client und der Portfreigabe. Löst auch hier den Token gleich ein, denn er steht nur im Journal des ersten Starts. Das Ablaufdatum der Lizenz zeigt sudo journalctl -u teamspeak | grep "ending date". Für ein Update stoppt ihr den Dienst, entpackt die neue Version über die alte und startet wieder. Datenbank und Einstellungen bleiben dabei erhalten:

sudo systemctl stop teamspeak
cd /tmp
curl -LO https://github.com/teamspeak/teamspeak6-server/releases/latest/download/teamspeak6-server-linux-arm64.tar.xz
sudo tar -xJf teamspeak6-server-linux-arm64.tar.xz -C /opt/teamspeak/server
sudo chown -R teamspeak:teamspeak /opt/teamspeak/server
sudo systemctl start teamspeak

Häufige Fragen zum TeamSpeak-Server auf dem Raspberry Pi

Läuft der TeamSpeak-3-Server auf dem Raspberry Pi?

Nein. TeamSpeak bietet den TS3-Server nur für x86- und amd64-Prozessoren an, eine Version für ARM gibt es nicht. Auf dem Raspberry Pi läuft der TeamSpeak-6-Server, den es offiziell für ARM64 gibt.

Kostet ein TeamSpeak-Server auf dem Raspberry Pi etwas?

Nein. Jede Version des TeamSpeak-6-Servers bringt eine kostenlose Lizenz für einen virtuellen Server mit 32 Plätzen mit. Größere Lizenzen gibt es für TS6 während der Beta noch nicht.

Können sich TeamSpeak-3-Nutzer mit einem TeamSpeak-6-Server verbinden?

Ja. Laut TeamSpeak verbinden sich TS6-Clients und TS3-Clients ab Version 3.6.0 mit demselben Server. Funktionen, die es nur in TeamSpeak 6 gibt, fehlen im TS3-Client.

Was passiert, wenn die Beta-Lizenz abläuft?

Der Server startet nicht mehr und meldet im Log, dass die Standardlizenz abgelaufen ist. Abhilfe ist ein Update auf die neueste Version, mit Docker per docker compose pull und docker compose up -d. Channels und Rechte bleiben dabei erhalten.

Welche Ports muss ich für TeamSpeak freigeben?

Pflicht ist 9987 UDP für die Sprache. Für Dateiübertragungen kommt 30033 TCP dazu. Die ServerQuery-Ports 10022 und 10080 gebt ihr nicht im Router frei.

Den Docker-Container könnt ihr mit Portainer auch im Browser starten, stoppen und aktualisieren. Weitere Ideen für euren Pi findet ihr in unseren 31 Raspberry Pi Projekten. Viel Spaß beim Zocken und Quatschen!

Ähnliche Beiträge