Host a TeamSpeak Server with Pterodactyl

This guide shows how to host your own TeamSpeak 3 voice server with Pterodactyl: use the bundled Egg, create the server, save the privilege key and claim admin rights in the TeamSpeak client.

Prerequisite: This guide assumes the basic Pterodactyl setup — including node and allocation configuration — is already complete. The TeamSpeak 3 Egg is part of the standard Pterodactyl installation; you only need a third-party Egg for other variants such as TeamSpeak 6. Learn more about third-party Eggs →

Step 1: Check the TeamSpeak Egg

Pterodactyl ships with a TeamSpeak 3 Egg, so you do not need to import anything:

1.In the Admin Area, click Nests and open the Voice Servers Nest

2.Check that the Teamspeak3 Server Egg is listed. If you want to run TeamSpeak 6 instead, you can import the TeamSpeak 6 Server Egg from the Egg library

Step 2: Add the TeamSpeak Ports

Every port the server uses must exist as an allocation on your node:

1.In the Admin Area, open Nodes, select your node and switch to the Allocation tab

2.Under Assign New Allocations, add port 9987 — the default TeamSpeak voice port (UDP)

3.If you need file transfers or ServerQuery, also add ports 30033 and 10011 — the Egg uses these ports by default

4.Click Submit

Step 3: Create the TeamSpeak Server

Create your TeamSpeak server instance in the panel. TeamSpeak is very lightweight — even a small RAM limit is sufficient for most setups.

1.Navigate to Servers → Create New

2.Enter a server name, set yourself as the owner and choose port 9987 as the Default Allocation — add 30033 and 10011 under Additional Allocation(s) if needed

3.Under Nest Configuration, select the Voice Servers Nest and the Teamspeak3 Server Egg

4.Set your resource limits (CPU, RAM, disk)

5.Click Create Server

Step 4: Start the Server and Save the Privilege Key

Start the server for the first time and save your administrator token:

1.Open the console of your newly created TeamSpeak server in the panel

2.Click Start

3.Watch the console output — on the first start, the server generates a Privilege Key in the form token=abc123xyz456...

Copy your Privilege Key immediately! It is only displayed once on the first start and is required to grant yourself administrator rights on your TeamSpeak server. Store it somewhere safe.

Step 5: Connect and Claim Admin Rights

Connect to your new TeamSpeak server and activate your administrator rights:

1.Open your TeamSpeak 3 client

2.Go to Connections → Connect

3.Enter your server's IP address and click Connect

4.On first connection you will be prompted for the Privilege Key — paste the token you copied from the console to become server administrator

Further Documentation

For advanced TeamSpeak configuration, refer to the official TeamSpeak documentation.

Download TeamSpeak