Windows How to Install and Configure a TeamSpeak Server With a Different Voice Port


(20180107 – The steps in this post were amended to address changes in recent versions of software — iceflatline)

TeamSpeak is a voice communication tool for online gaming, education and training, internal business communication, and similar use cases. This post will describe how to install TeamSpeak server on the Windows operating system, configure it to listen for incoming voice connections using a non-default UDP port, and test the installation/configuration using the TeamSpeak client application. Also discussed is how to remove your TeamSpeak server from the list of publicly available servers. The versions for the software discussed in this post are as follows:

  • Windows 10 Pro x64
  • TeamSpeak Server 64-bit
  • teamSpeak Client 64-bit 3.1.7
  • Let’s get started…

    Install and Configure the TeamSpeak Server

    Start by downloading the TeamSpeak server and extracting the folder contained within the zip file to a location of your choice. We’ll use C:\ in our example. After the folder is extracted we should see the folder C:\teamspeak3-server_win64.

    Open this folder and create a shortcut to C:\teamspeak3-server_win64\ts3server.exe to somewhere convenient. Right-click on the shortcut, navigate to Properties, and append createinifile=1 to C:\teamspeak3-server_win64\ts3server.exe in the Target field (e.g. C:\teamspeak3-server_win64\ts3server.exe createinifile=1) then select “OK” to save and close the window.

    Double-click on this shortcut to start the TeamSpeak server. You should see a new icon in the notification area of the windows task bar indicating that the TeamSpeak server has started. When the TeamSpeak server is started for the first time a pop-up window will appear showing the Server Query credentials and the Server Admin Token (See Figure 1). You can disregard this information for now and close the window.

    Screenshot showing the Server Query credentials and Server Admin Token after initial TeamSpeak server startup

    Figure 1

    Now open the folder C:\teamspeak3-server_win64 and you should see several new files, including ts3server.ini and ts3server.sqlitedb.

    Stop the TeamSpeak server by right-clicking on the icon in the notification tray and selecting “Exit”. Delete the file C:\teamspeak3-server_win64\ts3server.sqlitedb. Open C:\teamspeak-3-server\ts3server.ini and change the value of default_voice_port value to the port number desired. We’ll use 12010 in our example.

    Once again right-click on the shortcut, navigate to Properties. Replace createinifile=1 with inifile=ts3server.ini in the Target field (e.g., C:\teamspeak3-server_win64\ts3server.exe inifile=ts3server.ini) then select “OK” to save and close the window.

    Restart the Teamspeak server and a new C:\teamspeak3-server_win64\ts3server.sqlitedb file will be created containing the new port number. The pop-up window showing the Server Query credentials and the Server Admin Token will again appear. This time you’ll want to copy at least the Server Admin Token somewhere as this key is needed to gain administration rights to your TeamSpeak server. I also recommend copying the Server Query credential somewhere as well. This will be needed should you ever want to use ServerQuery, a command line based administration tool supported by TeamSpeak.

    Test Using the TeamSpeak Client

    Okay, now that we have the TeamSpeak server installed and configured let’s install the TeamSpeak client and test to ensure that you can connect to it.

    Download the TeamSpeak client application and install it. Start the TeamSpeak server and then start the TeamSpeak client. Once the TeamSpeak client has started select Connections->Connect (or use CTRL+s). In the Server Address field enter the host name of the Teamspeak server followed by the port number the server is listening on for incoming voice connections. These two entries should be seperated with a colon. Since our Teamspeak server is located on the same machine as the TeamSpeak client we’ll use the host name localhost. The port number will of course be the one we configured for this Teamspeak server, port 12010 (See Figure 2):

    Screenshot showing a new TeamSpeak server address and UDP port being configured in the TeamSpeak client application

    Figure 2

    Select “Connect” and you’ll will be connected to your TeamSpeak server. A window will appear indicating that this is newly created Teamspeak server and that the administrative privileges have not yet been claimed. Enter your Server Admin Token, then select OK. Note that this pop-up window will occur each time you connect to the TeamSpeak server until you’ve used the Server Admin Token. An unused Server Admin Token can be entered at any time after you’ve connected to the TeamSpeak Server by selecting Permissions->Use Public Key.

    Now that you’ve verified that you can connect to your TeamSpeak server locally, make sure to forward the correct UDP port (12010 in our example) in your NAT gateway so that, if desired, TeamSpeak clients outside of your local network can connect to your Teamspeak server.

    Generating additional Server Admin Tokens

    What if you want to add administrative privileges to another TeamSpeak client so, for example, you can administer the TeamSpeak server remotely? No problem. Using the TeamSpeak client you used previously to enter your Server Admin Token with connect to your Teamspeak server and navigate to Permissions->Privilege Keys and select “Create”. In the next window select Server Admin from among the options in the Group field. Enter a description if desired then select “Create” (See Figure 3). You can use this new Server Admin Token with another TeamSpeak client by connecting to the TeamSpeak server and selecting Permissions->Use Public Key.

    Screenshot showing where to create a new Server Admin Token

    Figure 3

    You can revoke tokens at any time by navigating to Permissions->Privilege Keys, highlighting the desired token and selecting “Remove.”

    Prevent your TeamSpeak server from appearing in the public server list

    TeamSpeak servers are automatically added to a list of publicly available servers when installed. This may not be desirable. To remove your server from this public server list connect to your server using a TeamSpeak client with administrative privileges. Right-click on your server’s name and select Edit Virtual Server. Select the Misc tab and uncheck the option “Enable reporting to server list” then select “Apply” (See Figure 4).

    Screenshot showing where to disable public server listing in the TeamSpeak server configuration

    Figure 4


    Well there you have it. A post describing how to install TeamSpeak server on the Windows operating system. The developers of TeamSpeak should make it easier for server administrators to make simple modifications like changing the default ports. Until they do this article should help you make those changes.

    Leave a Reply