Pterodactyl Logo

Host a TeamSpeak Server with Pterodactyl

TeamSpeak is a popular voice communication application for online gaming and teams. With Pterodactyl, you can set up your own private TeamSpeak server quickly and easily using a community Egg.

Prerequisite: This guide assumes the basic Pterodactyl setup — including node and allocation configuration — is already complete. You will also need a third-party Egg. Learn more about third-party Eggs →

Step 1: Download the TeamSpeak Egg

First, download the TeamSpeak 3 server Egg from pterodactyleggs.com:

2.Download the file egg-teamspeak-3-server.json

Step 2: Import the Egg into Pterodactyl

Upload the downloaded Egg to your Pterodactyl panel:

1.Navigate to the Admin Area via the wrench icon ⚙
2.Click Nests in the sidebar
3.Click Import Egg and upload the .json file
4.Assign the Egg to a Nest — for example the default Voice Servers nest or a new one

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 and set yourself as the owner
3.Under Nest Configuration, select the nest containing the imported Egg, then select the TeamSpeak 3 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.