How to change the default port

tbarlow · December 8, 2025, 4:49am

Hello how do i go about changeing the default port from 9987 to a diff port number and as well as the other ports thanks

Terry

LeonMarcelHD · December 8, 2025, 3:33pm

You’ll find the parameters / configs for all the different setup methods here on GitHub:

github.com/teamspeak/teamspeak6-server

CONFIG.md

main

# CONFIG.md

### TeamSpeak 6 Server: Frequently Used Parameters & Environment Variables

This document outlines the most commonly used command-line parameters and their equivalent environment variables for configuring the TeamSpeak 6 server. You can configure the server using either of the following methods:
- Command-line flags
- Environment variables
- A `tsserver.yaml` configuration file

---

#### General & Core Server Configuration

| Parameter                     | Environment Variable           | Description                                                                                                                                           |
|-------------------------------|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| `--config-file <file>`        | `TSSERVER_CONFIG_FILE`         | Specifies the configuration file to load (e.g., `tsserver.yaml`).                                                                                     |
| `--license-path <path>`       | `TSSERVER_LICENSE_PATH`        | Directory path where the server will look for the `licensekey.dat` file.                                                                              |
| `--accept-license`            | `TSSERVER_LICENSE_ACCEPTED`    | Use the --accept-license flag or set the environment variable to 1 or accept to confirm that you have read and accepted the server license agreement. |
| `--default-voice-port <port>` | `TSSERVER_DEFAULT_PORT`        | Permanently sets the default UDP voice port for the first virtual server created (Default: 9987).                                                     |

This file has been truncated. show original

If you just want to change the voice port for a server you can go ahead with these ServerQuery commands:

login serveradmin PASSWORD
serverstop sid=1
use sid=1 -virtual
serveredit virtualserver_port=NEWVOICEPORT
use sid=0
serverstart sid=1

tbarlow · December 8, 2025, 11:00pm

ok thanks i will try that do i change the other ports the same way?

Terry

LeonMarcelHD · December 9, 2025, 9:32am

If you want to change the voice ports of the virtual servers, then you can use the Query commands.

If you want to change the ServerQuery port or File Transfer port, then you’ll need to use the parameters from our documentation.

tbarlow · December 11, 2025, 12:42am

Hello

Ok I am trying to start my server with the cfg file tsserver.yaml i read that if i want to use that file witch i have gotten it made it told me to run the server with the command ./tsserver and it will know to use the cfg file tsserver.yaml but when i do its not sure it for example in the cfg file i have it set to use port 2409 but when i run the ./tsserver it uses the port 9987 do i need to runn it with other flags any help here would be great im also trying to get it to load the web interface but it isn’t comeing up in my browser anyway thanks for the help in advance

Terry

LeonMarcelHD · December 11, 2025, 11:51am

The parameter will only work when using it on the first start. If the server has already been created then you’ll need to modify it trough the ServerQuery or reset the installation.

A first party web interface for the server does not exist. Only the WebQuery exists, this however is not a web interface.