How to enable the ServerQuery?

KDrumFTP · March 12, 2026, 5:10pm

Good afternoon.

I’m a beginner, and I’d like to know what commands I need to enter on my server to grant access to query admin.

I’m using Ubuntu server and Docker.

GingerFury_Phil · March 12, 2026, 6:21pm

Because you said ur using docker you can use the Environment Variables:

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

LeonMarcelHD · March 12, 2026, 6:50pm

Like mentioned by @GingerFury_Phil you’ll need to use the variables to enable the ServerQuery.

The ServerQuery access is disabled by default and needs to be enabled if needed. You should find the password in the first start up logs, however if you don’t have it on hand you can use the variable to set a custom password / to overwrite the default password.

Note that the Telnet Query is deprecated and you’ll need to use the SSH Query.

uHirsch · August 1, 2026, 6:40am

Hello i am hosting a TeamSpeak 6 server inside a docker container.

My docker compose looks like this mentioned in the Blog Post.
After pulling the latest Image i lost my privilege on the Server, since they are one time use my privilege Key won’t work and i tried to delete my container and start a new one with my compose but it showed me no new token.

I tried to generate a new token but i am unable to connect via telnet. I cannot find the port forwarding on my hosting provider. So i tried it from inside my Container by using the command

docker exec -u 0 -it teamspeak-server bash
login serveradmin

But my Password won’t work as well…

So i tried to change my Password with the variable TSSERVER_QUERY_ADMIN_PASSWORD mentioned on Github inside my compose. But it won’t work either.

Has anybody an similar issue or any further advise what i could try?

Thanks in regard

LeonMarcelHD · August 1, 2026, 7:51am

The Telnet Query is no longer supported on TS6 servers.

Make sure that port 10022 is forwarded and you’re using an SSH connection.

uHirsch · August 2, 2026, 4:39am

That did the charm thank you i am connected.

EDIT: Is there anything i need to enable additionally? I added the Portforwarding in my .yaml and i am able to connect. But reffering to this Post i tried to get my servergroupID with the command servergrouplist and am receiving the message
serveradmin> servergrouplist
error id=1024 msg=invalid\sserverID

LeonMarcelHD · August 2, 2026, 8:44am

You pretty much only need to use the following command before using the servergrouplist command

use 1

OR

use port=9987

Regarless, I’ve updated the post here, so it is easier to read. Thanks for your input

Lost admin on self hosted server // How to generate a new privilege key

Logging into the Query Account and creating a token

# If not run locally on the Server, change the IP accordingly)
ssh serveradmin@127.1 -p10022

# Now enter your password...

# The default virtual Server ID is 1, if changed you can use `use port=9987` to identify the server by its voice port
use 1 

# The default Server Admin Group ID is 6, if you want to create it for a different Server Group, use the command `servergrouplist` (check for the output: sgid=6 name=Server\sAdmin [...])
tokenadd tokentype=0 tokenid1=6 tokenid2=0



# You should now receive the following output: 
token=UadpbuJLf6FL6bWVuJ0W9+yml5btScRFJSs9NSuN

uHirsch · August 3, 2026, 2:00am

Nailed it thank you. The Output was still confusing but i was able to just copy past your commands.

serveradmin> use 1
error id=0 msg=ok