How to Host a TeamSpeak Server with Pterodactyl

TeamSpeak is a popular voice communication application used for online gaming, education, and businesses. Using Pterodactyl, you can easily set up and manage your own private TeamSpeak server with a third-party Egg.


ℹ️ Prerequisites

Important: This guide assumes you have already completed the initial Pterodactyl setup, including configuring your first Node. You will also need a third-party Egg.


Installation Steps

1. Download the TeamSpeak Egg

The first step is to download the Egg for the TeamSpeak 3 Server. The most common version is available on pterodactyleggs.com.
  1. Go to the TeamSpeak 3 Server Egg page.
  2. Download the file egg-teamspeak-3-server.json.

2. Import the Egg into Pterodactyl

Now you need to upload the downloaded Egg into your Pterodactyl Panel.
  1. Navigate to the Admin area by clicking the wrench icon in the upper right corner.
  2. Go to Nests in the sidebar.
  3. Click the green "Import Egg" button and upload the downloaded .json file.
  4. Assign the imported Egg to a Nest. You can use the default "Voice Servers" Nest or create a new one.

3. Create the TeamSpeak Server

With the Egg installed, you can now create your server instance.
  1. Go to the "Servers" page in the user view and click "Create New".
  2. Enter a name for your server and set yourself as the owner.
  3. Under "Nest Configuration," select the Nest where you imported the Egg (e.g., "Voice Servers"), and then choose the "TeamSpeak 3 Server" Egg from the dropdown menu.
  4. Set the resource limits (CPU, RAM, Disk). TeamSpeak is generally very resource-efficient.
  5. Click "Create Server".

4. Start the Server and Retrieve the Privilege Key

The final step is the initial start of the server to obtain your unique administrator token.
  1. Go to the console of your newly created TeamSpeak server.
  2. Click the "Start" button.
  3. Carefully observe the console output. Upon first startup, the server generates and displays a Privilege Key (also called a token). It will look something like this: token=abc123xyz456...

Critical: Copy your Privilege Key immediately! This key is only shown once during the initial startup. It is required to grant you administrator rights on your TeamSpeak server. Store it in a secure location.


5. Connect and Claim Admin Rights

After copying your key, you can connect to your server.
  1. Open your TeamSpeak 3 Client.
  2. Go to Connections > Connect.
  3. Enter your server's IP address into the "Server Nickname or Address" field and click "Connect."
  4. Upon first connection, you will be prompted to enter your Privilege Key. Paste the key you copied from the console to become the Server Administrator.