Knowledgebase
How do I add or remove my server from the Server List?

This FAQ Article covers how to add or remove a server from the Server List (in the TeamSpeak 3 Client: Connections, Server List), how to adapt the filter properly and how to grant or revoke the permission to toggle the server reporting to the Server List.

 

Before going into much detail about specific problems, please note:
The Server List only contains up to 100 servers matching your search criteria. If there are more than 100 servers matching your criteria, a randomized list of 100 servers will be shown. Parts of the list are cached in the client, meaning that this list will not be completely regenerated upon executing the same search. Some servers might therefore appear to occur more often across several searches.

 

My server is not in the Server List, how do I add it?

First things first - your server might actually be in the server list but your filtering could be wrong. In the Server List, set Country, Region and City to either "All" or, if you know in which area the server is hosted, the correct location. Also uncheck "Hide empty servers", "Hide full servers", "Servers with X to Y users" and "Servers with X to Y slots". Now click on "Advanced Filter" on the bottom of the filter and select "Show all" for both options. Now retry your query with the servers' name in the "Server name" section.

If you are renting a server
You might not have the permission to change whether or not your server will be listed on the weblist. If you do, you can change it as follows: Right click on your servers' name, Edit Virtual Server, click on the "More" button, select the "Misc" tab, check "Enable reporting to server list" and hit "Apply".
If your server still does not appear in the server list after this, or if you don't have the permission to check the checkbox, please contact your hoster.


If you are hosting your server
Please note: The port range (UDP out): 2011-2110 must not be blocked. For a list of all required ports, see here.
You should have access to the "serveradmin" Server Query account. If you don't, please check out this thread.
Please establish a connection to the Server Query interface using any telnet client (such as Putty). The default query port is 10011. Please replace anything written in CAPITAL letters:

login serveradmin SERVERADMIN_PASSWORD
use port=VOICE_PORT_OF_SERVER_TO_BE_EDITED
serveredit virtualserver_weblist_enabled=1
quit


You will need to repeat the steps above for any server on which you would like to enable the weblist reporting.
Please note: You can use "use 0" instead of "use port=SOME_VOICE_PORT" to edit the template server. Making any changes to the template server will only affect new virtual servers on this instance that you might create in the future.



How do I give/revoke my customers the permission to toggle the weblist reporting?

Just like above, please establish a telnet connection to the Server Query interface.
To add this permission to a single server group, please execute the following commands:

login serveradmin SERVERADMIN_PASSWORD
use port=VOICE_PORT_OF_SERVER_TO_BE_EDITED
servergroupaddperm sgid=GROUP_ID permsid=b_virtualserver_modify_weblist permvalue=1 permskip=0 permnegated=0|permsid=i_needed_modify_power_virtualserver_modify_weblist permvalue=75 permskip=0 permnegated=0
quit

Again, you can also edit the template groups. By default, the template server groups have the following group IDs:
Server Admin: 3
Normal: 4
Guest: 5

So the commands would be as such to add this permission to the Server Admin's template group:

login serveradmin SERVERADMIN_PASSWORD
use port=ANY_ACTIVE_VOICE_PORT
servergroupaddperm sgid=3 permsid=b_virtualserver_modify_weblist permvalue=1 permskip=0 permnegated=0|permsid=i_needed_modify_power_virtualserver_modify_weblist permvalue=75 permskip=0 permnegated=0
quit

You can also use the servergroupautoaddperm command to add this permission to an entire group of server groups (eg. all Server Admin groups). Whether a group is considered to be a Server Admin / Normal / Guest / Query Guest / ... group is determined by its i_group_auto_update_type:

The known values for sgtype are:

  • 10: Channel Guest
  • 15: Server Guest
  • 20: Query Guest
  • 25: Channel Voice
  • 30: Server Normal
  • 35: Channel Operator
  • 40: Channel Admin
  • 45: Server Admin
  • 50: Query Admin

So to add this permission to all existing Server Admin groups (including its template group), please execute the following commands:

login serveradmin SERVERADMIN_PASSWORD
use port=ANY_ACTIVE_VOICE_PORT
servergroupautoaddperm sgtype=45 permsid=b_virtualserver_modify_weblist permvalue=1 permskip=0 permnegated=0|permsid=i_needed_modify_power_virtualserver_modify_weblist permvalue=75 permskip=0 permnegated=0
servergroupaddperm sgid=3 permsid=b_virtualserver_modify_weblist permvalue=1 permskip=0 permnegated=0|permsid=i_needed_modify_power_virtualserver_modify_weblist permvalue=75 permskip=0 permnegated=0
quit


To revoke those permissions, please execute:

login serveradmin SERVERADMIN_PASSWORD
use port=ANY_ACTIVE_VOICE_PORT
servergroupautodelperm sgtype=45 permsid=b_virtualserver_modify_weblist|permsid=i_needed_modify_power_virtualserver_modify_weblist
servergroupdelperm sgid=3 permsid=b_virtualserver_modify_weblist|permsid=i_needed_modify_power_virtualserver_modify_weblist
quit

Or those commands, to remove it from a single server group:

login serveradmin SERVERADMIN_PASSWORD
use port=VOICE_PORT_OF_SERVER_TO_BE_EDITED
servergroupdelperm sgid=GROUP_ID permsid=b_virtualserver_modify_weblist|permsid=i_needed_modify_power_virtualserver_modify_weblist
quit

How do I remove my server from the server list?
Well it's done just like adding it. Simply uncheck the checkbox in the server settings, or execute "serveredit virtualserver_weblist_enabled=0" instead of "serveredit virtualserver_weblist_enabled=1".

(483 vote(s))
Helpful
Not helpful