Difference between revisions of "TeamSpeak"

From ArchWiki
Jump to navigation Jump to search
m (→‎Starting Teamspeak with disabled IPv6 stack: fix capitalization - kernel parameter is not a proper noun)
 
(29 intermediate revisions by 18 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:TeamSpeak}}
+
[[Category:Voice over IP]]
[[Category:Sound]]
+
[[ja:TeamSpeak]]
{{Article summary start}}
+
[[de:TeamSpeak]]
{{Article summary text|An introduction to [http://teamspeak.com/ TeamSpeak], covering installation and basic configuration of the client and server.}}
+
From [[Wikipedia:TeamSpeak]]:
{{Article summary end}}
 
  
From [http://en.wikipedia.org/wiki/Teamspeak Wikipedia, the free encyclopedia]:
+
:TeamSpeak is proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.
  
:''TeamSpeak is a proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.''
+
== Installation ==
 +
 
 +
=== Client ===
 +
 
 +
[[Install]] the {{Pkg|teamspeak3}} package.
  
== Installation ==
+
=== Server ===
  
===Install client===
+
Install the {{Pkg|teamspeak3-server}} package.
Install {{AUR|teamspeak3}}, available in the [[Arch User Repository]].
 
  
===Install server===
+
== Server configuration and startup ==
Install {{AUR|teamspeak3-server}}, available in the [[Arch User Repository]].
 
  
== Configuration/Startup ==
+
=== Configuration ===
=== Client ===
 
I do not use the client with Linux, please feel free to expand this article at this point or delete this section if there is nothing to write about.
 
  
=== Server ===
+
* You can configure the TeamSpeak server. If you are using [[systemd]] please check {{ic|/usr/share/doc/teamspeak3-server/doc/server_quickstart.txt}} for all available command line parameters.
==== Configuration ====
 
* You can configure the TeamSpeak server via {{ic|/etc/conf.d/teamspeak3-server}}. You can find all necessary explanations inside this file.
 
  
 
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
 
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
  
==== First startup ====
+
=== First startup ===
At the first startup TeamSpeak creates the SQLite database at {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and the first logfiles. At the same moment TeamSpeak creates the ServerQuery administration account (the superuser of all servers) and the first virtual server including a privilege key for the server administrator of this virtual server. The ServerQuery account is displayed only once on standard output. If you have already started your server and missed it you have to delete {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and clear {{ic|/var/log/teamspeak3-server/}} of all logfiles.
+
 
 +
With the first startup TeamSpeak creates the SQLite database at {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and starts logging its standard output in files in: {{ic|/var/log/teamspeak3-server/}}. Teamspeak also creates the first ServerQuery administration account (the superuser) and the first virtual server including a privilege key for the server administrator of this virtual server. The privilege key is only displayed once on standard output.
 +
 
 +
* [[Start]] the {{ic|teamspeak3-server}} service.
 +
 
 +
* To find the privilege key:
 +
$ systemctl status teamspeak3-server
 +
 
 +
* Scan the output for the privilege key:
 +
{{hc|Example output:|<nowiki>
 +
● teamspeak3-server.service - TeamSpeak3 Server
 +
  Loaded: loaded (/usr/lib/systemd/system/teamspeak3-server.service; enabled; vendor preset: disabled)
 +
  Active: active (running) since Sat 2015-09-05 23:34:42 BST; 49min ago
 +
Main PID: 20126 (teamspeak3-serv)
 +
  CGroup: /system.slice/teamspeak3-server.service
 +
          └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/
 +
 
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                   
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: ------------------------------------------------------------------
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.322567|INFO    |CIDRManager  |  | updated query_ip_whitelist ips: 127.0.0.1,
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.323806|INFO    |Query        |  | listening on 0.0.0.0:10011
 +
Sep 05 23:34:53 Your-Hostname systemd[1]: Started TeamSpeak3 Server.
 +
</nowiki>}}
 +
 
 +
* The privilege key is what token is equal to.
 +
 
 +
* Alternatively, you can navigate to the logs directory for teamspeak3-server and read the output log directly. (This is a persistent file and will still have the first startup output here even if you have restarted the server):
 +
{{Note| You have to be have either be logged in as root or as the teamspeak user to access this directory!}}
 +
$ cd /var/log/teamspeak3-server
 +
$ cat ts3server_*.log
 +
 
 +
Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.
 +
 
 +
=== Regular startup ===
 +
 
 +
Simply [[enable]] the {{ic|teamspeak3-server}} service.
 +
 
 +
=== Re-Initialising Teamspeak ===
 +
 
 +
If you have used the initial privilege key and have lost server permissions (e.g. your teamspeak 3 client with superadmin rights was uninstalled) you will have to start from scratch.
  
 
{{Warning|These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.}}
 
{{Warning|These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.}}
  
* Stop teamspeak3-server (see [[Daemon]]).
+
* [[Stop]] the {{ic|teamspeak3-server}} service.
  
 
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
 
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
{{bc|
+
 
rm /var/lib/teamspeak3-server/ts3server.sqlitedb}}
+
$ rm /var/lib/teamspeak3-server/ts3server.sqlitedb
  
 
* Clear {{ic|/var/log/teamspeak3-server/}}:
 
* Clear {{ic|/var/log/teamspeak3-server/}}:
{{bc|
+
$ rm /var/log/teamspeak3-server/*.log
rm /var/log/teamspeak3-server/*.log}}
 
 
 
* Now you can run the server (as root):
 
{{bc|
 
<nowiki>su -s /bin/bash -c "/usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/opt/teamspeak3-server/sql/ &" teamspeak</nowiki>}}
 
 
 
{{Note|Write down the password for the ServerQuery administrator!}}
 
  
* The output should be similar to this:
+
* Now follow the same instructions for a first time setup.
{{hc|Example output|
 
<nowiki>------------------------------------------------------------------
 
                        I M P O R T A N T                         
 
------------------------------------------------------------------
 
              Server Query Admin Acccount created               
 
          loginname= "serveradmin", password= "gEqqREzr"
 
------------------------------------------------------------------</nowiki>}}
 
  
* You will find the privilege key of the first virtual server in this output. But it is also written to the logfile at {{ic|/var/log/teamspeak3-server/}}.
+
=== Starting Teamspeak with disabled IPv6 stack ===
  
* You can stop the server with this (32-bit):
+
When booting your system with the {{ic|1=ipv6.disable=1}} [[kernel parameter]] to [[IPv6#Disable functionality|disable the IPv6 stack]], Teamspeak wont be able to start with the default configuration. Edit {{ic|/etc/teamspeak3-server.ini}} to change the listening IPs.
{{bc|
 
kill `pidof -o %PPID /opt/teamspeak3-server/ts3server_linux_x86`}}
 
  
or this (64-bit):
+
{{hc|head=/etc/teamspeak3-server.ini|output=
 +
# query_ip=0.0.0.0, ::
 +
query_ip=0.0.0.0
 +
}}
  
{{bc|
+
== See also ==
kill `pidof -o %PPID /opt/teamspeak3-server/ts3server_linux_x64`}}
 
  
==== Regular startup ====
+
* [https://www.teamspeak.com/en/ Official website]
Simply start teamspeak3-server (see [[Daemon]]).
 

Latest revision as of 14:09, 18 November 2018

From Wikipedia:TeamSpeak:

TeamSpeak is proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.

Installation

Client

Install the teamspeak3 package.

Server

Install the teamspeak3-server package.

Server configuration and startup

Configuration

  • You can configure the TeamSpeak server. If you are using systemd please check /usr/share/doc/teamspeak3-server/doc/server_quickstart.txt for all available command line parameters.
  • If you possess a license file please copy it to /var/lib/teamspeak3-server/licensekey.dat.

First startup

With the first startup TeamSpeak creates the SQLite database at /var/lib/teamspeak3-server/ts3server.sqlitedb and starts logging its standard output in files in: /var/log/teamspeak3-server/. Teamspeak also creates the first ServerQuery administration account (the superuser) and the first virtual server including a privilege key for the server administrator of this virtual server. The privilege key is only displayed once on standard output.

  • Start the teamspeak3-server service.
  • To find the privilege key:
$ systemctl status teamspeak3-server
  • Scan the output for the privilege key:
Example output:
● teamspeak3-server.service - TeamSpeak3 Server
   Loaded: loaded (/usr/lib/systemd/system/teamspeak3-server.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2015-09-05 23:34:42 BST; 49min ago
 Main PID: 20126 (teamspeak3-serv)
   CGroup: /system.slice/teamspeak3-server.service
           └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/

Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                     
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: ------------------------------------------------------------------
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.322567|INFO    |CIDRManager   |   | updated query_ip_whitelist ips: 127.0.0.1,
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.323806|INFO    |Query         |   | listening on 0.0.0.0:10011
Sep 05 23:34:53 Your-Hostname systemd[1]: Started TeamSpeak3 Server.
  • The privilege key is what token is equal to.
  • Alternatively, you can navigate to the logs directory for teamspeak3-server and read the output log directly. (This is a persistent file and will still have the first startup output here even if you have restarted the server):
Note: You have to be have either be logged in as root or as the teamspeak user to access this directory!
$ cd /var/log/teamspeak3-server
$ cat ts3server_*.log

Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.

Regular startup

Simply enable the teamspeak3-server service.

Re-Initialising Teamspeak

If you have used the initial privilege key and have lost server permissions (e.g. your teamspeak 3 client with superadmin rights was uninstalled) you will have to start from scratch.

Warning: These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.
  • Stop the teamspeak3-server service.
  • Remove /var/lib/teamspeak3-server/ts3server.sqlitedb:
$ rm /var/lib/teamspeak3-server/ts3server.sqlitedb
  • Clear /var/log/teamspeak3-server/:
$ rm /var/log/teamspeak3-server/*.log
  • Now follow the same instructions for a first time setup.

Starting Teamspeak with disabled IPv6 stack

When booting your system with the ipv6.disable=1 kernel parameter to disable the IPv6 stack, Teamspeak wont be able to start with the default configuration. Edit /etc/teamspeak3-server.ini to change the listening IPs.

/etc/teamspeak3-server.ini
# query_ip=0.0.0.0, ::
query_ip=0.0.0.0

See also