Difference between revisions of "TeamSpeak"

From ArchWiki
Jump to navigation Jump to search
m (Style)
m (Starting Teamspeak with disabled IPv6 stack: fix capitalization - kernel parameter is not a proper noun)
 
(18 intermediate revisions by 14 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.
 +
 
 +
=== Server ===
 +
 
 +
Install the {{Pkg|teamspeak3-server}} package.
 +
 
 +
== Server configuration and startup ==
 +
 
 +
=== Configuration ===
 +
 
 +
* 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.
  
== Installation ==
+
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
  
===Install client===
+
=== First startup ===
  
[[pacman|Install]] {{Pkg|teamspeak3}}, available in the [[official repositories]].
+
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.
  
===Install server===
+
* [[Start]] the {{ic|teamspeak3-server}} service.
  
Install {{AUR|teamspeak3-server}}, available in the [[AUR]].
+
* To find the privilege key:
 +
$ systemctl status teamspeak3-server
  
== Configuration and startup ==
+
* 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/
  
=== Client ===
+
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>}}
  
I do not use the Linux client, please feel free to expand this article at this point.
+
* The privilege key is what token is equal to.
  
=== Server ===
+
* 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
  
==== Configuration ====
+
Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.
  
* You can configure the TeamSpeak server. If you are using [[systemd]] please check {{ic|/usr/share/doc/teamspeak3-server/server_quickstart.txt}} for all available command line parameters.
+
=== Regular startup ===
  
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
+
Simply [[enable]] the {{ic|teamspeak3-server}} service.
  
==== First startup ====
+
=== Re-Initialising Teamspeak ===
  
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 as described below.
+
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}}:
  
  # 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/}}:
  # rm /var/log/teamspeak3-server/*.log
+
  $ rm /var/log/teamspeak3-server/*.log
 
 
* Now you can run the server (as root):
 
# su -s /bin/bash -l -c "/usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/" teamspeak
 
 
 
* You should see an output similar to this:
 
{{hc|Example output|<nowiki>
 
------------------------------------------------------------------
 
                        I M P O R T A N T                         
 
------------------------------------------------------------------
 
              Server Query Admin Acccount created               
 
          loginname= "serveradmin", password= "password"
 
------------------------------------------------------------------
 
</nowiki>}}
 
 
 
{{Note|Write down the password for the ServerQuery administrator!}}
 
  
* You will also find the privilege key of the first virtual server in this output which can be used to gain administrative rights on this virtual server. But the key is also written to the logfile at {{ic|/var/log/teamspeak3-server/}} and you can see it in {{ic|<nowiki>#  journalctl _SYSTEMD_UNIT=teamspeak3-server.service </nowiki>}}
+
* Now follow the same instructions for a first time setup.
  
* You can stop the server with this:
+
=== Starting Teamspeak with disabled IPv6 stack ===
# kill $(pidof -o %PPID /usr/bin/teamspeak3-server)
 
  
==== Regular startup ====
+
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.
  
Simply start teamspeak3-server. See [[Daemon]].
+
{{hc|head=/etc/teamspeak3-server.ini|output=
 +
# query_ip=0.0.0.0, ::
 +
query_ip=0.0.0.0
 +
}}
  
 
== See also ==
 
== See also ==
  
* [http://www.teamspeak.com/?page=literature Official documentation]
+
* [https://www.teamspeak.com/en/ Official website]

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