NEW 📢 Black Friday: our launch offer ends 30 Nov. Up to 70% off your first month on every game!See plans
Black FridayUp to 70% off your first month, ends 30 NovEnds in 9d 02h 53mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 02h 53mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 02h 53m

How to get a new TeamSpeak server admin privilege key

Mumble and voice serversUpdated Nov 21, 20267 min read

Short answer. A new TeamSpeak server prints a ServerAdmin privilege key (a line starting with token=) the first time it starts, in the console and in the log of virtual server 1. A key works only once. To make a new one on TeamSpeak 3, log in to ServerQuery as serveradmin and run privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0; on TeamSpeak 6, send the same command to the HTTP query with an API key. Lost the ServerQuery password too? Start TeamSpeak 3 once with serveradmin_password=, or TeamSpeak 6 with --query-http-enable and --query-admin-api-key. We made new keys this way on TeamSpeak 3 server 3.13.8 and TeamSpeak 6 server v6.0.0-beta13.1 on 6 November 2026. TeamSpeak 6 server v6.0.0-beta14 was released on 17 November 2026; we have not repeated these steps on it.

What the privilege key is

TeamSpeak's own guide (doc/privilegekey_guide.txt in the TeamSpeak 3 download) says a TeamSpeak 3 server has no user login names or passwords: it knows people by a unique ID made from a key pair their client creates. So the first admin needs a ticket: the privilege key. TeamSpeak 6 uses the same kind of key. Pasting it into the TeamSpeak client puts that identity into the Server Admin group of the virtual server the key was made for. The same guide says a key can be used only once.

Find the key from the first start

On the first start both versions print the same two lines:

ServerAdmin privilege key created, please use the line below
token=...
  • TeamSpeak 3 on Linux: the server writes it to the log of virtual server 1, the file in logs/ whose name ends in _1.log:
    grep token= logs/*_1.log
  • TeamSpeak 6 with Docker:
    docker logs teamspeak-server 2>&1 | grep token=
  • TeamSpeak 6 without Docker: the same grep as TeamSpeak 3, in the server's logs/ folder.

The first start also prints a ServerQuery login in a box on the console: loginname= "serveradmin", password= "..." and an apikey. Keep them somewhere safe. They are printed on the first start only, and they are what you use to make a new key.

Make a new key on TeamSpeak 3

Run this on the machine where the server runs. ServerQuery listens on TCP port 10011, which should not be open to the internet.

  1. Connect to ServerQuery with a plain TCP client. TeamSpeak's ServerQuery manual names Telnet (on Debian or Ubuntu, sudo apt install telnet if it is missing):
    telnet 127.0.0.1 10011
  2. Log in, pick virtual server 1 and make the key:
    login serveradmin YOUR_QUERY_PASSWORD
    use sid=1
    privilegekeyadd tokentype=0 tokenid1=6 tokenid2=0
    quit
  3. The server answers token=... followed by error id=0 msg=ok. Paste the token into your TeamSpeak client. ServerQuery escapes a slash as \/ in its answers, so if the token shows \/, type it as /.

tokenid1=6 is the Server Admin group of a new virtual server: the key the server makes on its first start points at group 6 as well. If you renamed or rebuilt your groups, run servergrouplist after use sid=1 and take the sgid of the admin group with type=1. Groups with type=0 are templates and type=2 are ServerQuery groups.

Lost the ServerQuery password

TeamSpeak's quickstart guide says the only way to get a new password is to delete the server database. On 3.13.8 there is a gentler way: start the server once with a new password as a start parameter. The start script passes parameters on to the server. Use letters and digits only, because ServerQuery treats spaces and some symbols as special characters:

./ts3server_startscript.sh stop
./ts3server_startscript.sh start serveradmin_password=PICK_A_NEW_PASSWORD

In our test the log then said updated server query admin password and the new password logged in. Make your new key as above while the server runs, then restart it the normal way.

Make a new key on TeamSpeak 6

TeamSpeak 6 has no plain-text ServerQuery on port 10011: its CONFIG.md lists SSH, HTTP and HTTPS query interfaces, all off by default. The HTTP query takes an API key that you set at start.

  1. Restart the server with the HTTP query on and an API key of your own:
    ./tsserver --accept-license --query-http-enable --query-admin-api-key PICK_A_LONG_RANDOM_KEY
    The HTTP query then listens on TCP 10080 on all addresses (0.0.0.0), so make sure your firewall blocks that port from the internet.
  2. On the same machine, ask for a key for group 6:
    curl -H "x-api-key: PICK_A_LONG_RANDOM_KEY" "http://127.0.0.1:10080/1/privilegekeyadd?tokentype=0&tokenid1=6&tokenid2=0"
  3. The answer is JSON: {"body":[{"token":"..."}],"status":{"code":0,"message":"ok"}}. Paste the token into your TeamSpeak client. The server log adds a line saying serveradmin added a privilege key for servergroup Server Admin.
  4. Restart without --query-http-enable if you do not need the HTTP query.

With Docker, recreate the container with two environment variables and the HTTP query port published on 127.0.0.1 only, so it is not reachable from the internet. Your data stays in the volume:

docker rm -f teamspeak-server
docker run -d \
  --name teamspeak-server \
  -p 9987:9987/udp \
  -p 30033:30033 \
  -p 127.0.0.1:10080:10080 \
  -e TSSERVER_LICENSE_ACCEPTED=accept \
  -e TSSERVER_QUERY_HTTP_ENABLED=1 \
  -e TSSERVER_QUERY_ADMIN_API_KEY=PICK_A_LONG_RANDOM_KEY \
  -v teamspeak-data:/var/tsserver/ \
  teamspeaksystems/teamspeak6-server:latest

Then run the same curl as in step 2. Use environment variables here, not options after the image name: the image's command is tsserver, so anything after the image name replaces it, and in our test the HTTP query did not answer when we tried it that way. Recreate the container without the two query variables and the 10080 port when you no longer need the HTTP query. --query-admin-password (TSSERVER_QUERY_ADMIN_PASSWORD) sets the password of the serveradmin query account; the HTTP query above does not need it (our Docker test set only the API key), and the SSH query is off until you add --query-ssh-enable.

The key says it is invalid

  • It was used already. Each key works once. privilegekeylist (TeamSpeak 3) or /1/privilegekeylist (TeamSpeak 6) lists the keys that are still available.
  • It is for another virtual server. A key works only on the virtual server it was made for.
  • The HTTP query answers invalid apikey. The x-api-key header does not match the key the server started with.
  • Part of it was not copied. A key can contain + and /. Copy everything after token=.

Hosting TeamSpeak yourself

The full setup, the licence limits and how much memory the server needs: How to host a TeamSpeak server. PlayNHost rents Mumble voice servers, not TeamSpeak; on Mumble the first admin uses a SuperUser password from the panel instead of a key: How to become admin on your Mumble server.

Already hosting it somewhere else? Move your server to us

OUR LATEST BLOGS