Difference between revisions of "TeamSpeak"

From ArchWiki
Jump to navigation Jump to search
(There is no need for having the su -s /bin/bash method here, as systemd manages the service completely. For getting the automatically created privilege key, it is simply easier to read the logfile either with an editor or cat, or use systemctl status.)
m (Starting Teamspeak with disabled IPv6 stack: fix capitalization - kernel parameter is not a proper noun)
 
(12 intermediate revisions by 10 users not shown)
Line 1: Line 1:
[[Category:Telephony and voice]]
+
[[Category:Voice over IP]]
From [[Wikipedia:TeamSpeak|Wikipedia, the free encyclopedia]]:
+
[[ja:TeamSpeak]]
 +
[[de:TeamSpeak]]
 +
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.''
+
: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 ==
 
== Installation ==
  
===Client===
+
=== Client ===
  
[[pacman|Install]] {{Pkg|teamspeak3}}, available in the [[official repositories]].
+
[[Install]] the {{Pkg|teamspeak3}} package.
  
===Server===
+
=== Server ===
 
 
Install {{AUR|teamspeak3-server}}, available in the [[AUR]].
 
  
== Configuration and Startup ==
+
Install the {{Pkg|teamspeak3-server}} package.
  
=== Server ===
+
== Server configuration and startup ==
  
==== Configuration ====
+
=== Configuration ===
  
* 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.
+
* 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.
  
 
* 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 ===
  
 
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.
 
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 service with systemctl:
+
* [[Start]] the {{ic|teamspeak3-server}} service.
$ systemctl start teamspeak3-service
 
  
 
* To find the privilege key:
 
* To find the privilege key:
Line 43: Line 42:
 
           └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/
 
           └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/
  
Sep 05 23:34:45 Wildefyr-Server teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
Sep 05 23:34:45 Wildefyr-Server teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
Sep 05 23:34:45 Wildefyr-Server teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                     
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                     
Sep 05 23:34:45 Wildefyr-Server teamspeak3-server[20126]: ------------------------------------------------------------------
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: ------------------------------------------------------------------
Sep 05 23:34:45 Wildefyr-Server 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.322567|INFO    |CIDRManager  |  | updated query_ip_whitelist ips: 127.0.0.1,
Sep 05 23:34:45 Wildefyr-Server teamspeak3-server[20126]: 2015-09-05 22:34:45.323806|INFO    |Query        |  | listening on 0.0.0.0:10011
+
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 Wildefyr-Server systemd[1]: Started TeamSpeak3 Server.
+
Sep 05 23:34:53 Your-Hostname systemd[1]: Started TeamSpeak3 Server.
 
</nowiki>}}
 
</nowiki>}}
  
Line 61: Line 60:
 
Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.
 
Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.
  
==== Regular startup ====
+
=== Regular startup ===
  
Simply enable teamspeak3-server with systemctl:
+
Simply [[enable]] the {{ic|teamspeak3-server}} service.
$ systemctl enable teamspeak3-service
 
  
See [[Daemon]] for more information.
+
=== Re-Initialising Teamspeak ===
  
=== 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.
 
 
If you have used the initial privilege key and have lost server permissions (i.e. 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:
+
* [[Stop]] the {{ic|teamspeak3-server}} service.
$ systemctl stop teamspeak3-server
 
  
 
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
 
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
Line 85: Line 80:
  
 
* Now follow the same instructions for a first time setup.
 
* Now follow the same instructions for a first time setup.
 +
 +
=== Starting Teamspeak with disabled IPv6 stack ===
 +
 +
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.
 +
 +
{{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