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.
- Go to the TeamSpeak 3 Server Egg page.
- 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.
- Navigate to the Admin area by clicking the wrench icon in the upper right corner.
- Go to Nests in the sidebar.
- Click the green "Import Egg" button and upload the downloaded
.json
file. - 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.
- Go to the "Servers" page in the user view and click "Create New".
- Enter a name for your server and set yourself as the owner.
- 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.
- Set the resource limits (CPU, RAM, Disk). TeamSpeak is generally very resource-efficient.
- 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.
- Go to the console of your newly created TeamSpeak server.
- Click the "Start" button.
- 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.
- Open your TeamSpeak 3 Client.
- Go to Connections > Connect.
- Enter your server's IP address into the "Server Nickname or Address" field and click "Connect."
- 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.