Difference between revisions of "TeamSpeak"

From ArchWiki
Jump to: navigation, search
m (Edited out example hostname.)
(some style fixes, see Help:Style and related)
Line 1: Line 1:
 
[[Category:Telephony and voice]]
 
[[Category:Telephony and voice]]
From [[Wikipedia:TeamSpeak|Wikipedia, the free encyclopedia]]:
+
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]].
+
Install the {{AUR|teamspeak3-server}} package.
  
== Configuration and Startup ==
+
== Configuration and startup ==
  
 
=== Server ===
 
=== Server ===
Line 24: Line 24:
 
* 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 63: Line 62:
 
==== 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.
 
See [[Daemon]] for more information.
  
=== Re-Initialising Teamspeak ===  
+
=== Re-Initialising Teamspeak ===
  
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!
+
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:
+
* [[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}}:

Revision as of 04:03, 7 September 2015

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-serverAUR package.

Configuration and startup

Server

Configuration

  • You can configure the TeamSpeak server. If you are using systemd please check /usr/share/doc/teamspeak3-server/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.

See Daemon for more information.

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.

See also