docker-teamspeak

 1> **Archived.** This project is no longer in use and no longer maintained. Last updated June 2018.
 2
 3# docker-teamspeak
 4
 5A nice and easy way to get a TeamSpeak server up and running using docker. For
 6help on getting started with docker see the [official getting started guide][0].
 7For more information on TeamSpeak and check out it's [website][1].
 8
 9
10## Building docker-teamspeak
11
12Running this will build you a docker image with the latest version of both
13docker-teamspeak and TeamSpeak itself.
14
15    git clone https://github.com/overshard/docker-teamspeak
16    cd docker-teamspeak
17    docker build -t overshard/teamspeak .
18
19
20## Running docker-teamspeak
21
22Running the first time will set your port to a static port of your choice so
23that you can easily map a proxy to. If this is the only thing running on your
24system you can map the ports to 9987, 10011, 30033 and no proxy is needed. i.e.
25`-p=9987:9987/udp  -p=10011:10011 -p=30033:30033` Also be sure your mounted
26directory on your host machine is already created before running
27`mkdir -p /mnt/teamspeak`.
28
29    sudo docker run -d=true -p=9987:9987/udp -p=10011:10011 -p=30033:30033 -v=/mnt/teamspeak:/data overshard/teamspeak /start
30
31With Teamspeak v3.1 Teamspeak has changed it's license and license policy, before you can start the server you have to accept the License.
32This you can do by having a file called .ts3server_license_accepted in the working directory or define the enviroment variable
33TS3SERVER_LICENSE=accept. For the later add to the docker command the following option:
34
35    -e TS3SERVER_LICENSE='accept'
36
37E.g. 
38
39    sudo docker run -d=true -p=9987:9987/udp -p=10011:10011 -p=30033:30033 -v=/mnt/teamspeak:/data -e TS3SERVER_LICENSE='accept' overshard/teamspeak /start
40
41From now on when you start/stop docker-teamspeak you should use the container id
42with the following commands. To get your container id, after you initial run
43type `sudo docker ps` and it will show up on the left side followed by the image
44name which is `overshard/teamspeak:latest`.
45
46    sudo docker start <container_id>
47    sudo docker stop <container_id>
48
49## File Permissions
50
51Docker has no way to change file permissions at runtime without being root. Because of that you have to make sure every file you want the container to use (database or previous logs) is owned by uid and gid 1000.   
52Run `chown 1000:1000 <filename(s)>` on every file or Run `chown -R 1000:1000 /mnt/teamspeak` to fix all permissions recursively.   
53
54## docker-compose
55
56You can use docker-compose to simplify the process of building and running.   
57If you do not wish to import an existing database or logfiles just run:
58
59    sudo docker-compose up
60This will build and run the container.   
61If you want to import existing logs or a database read `File Permissions` first.
62
63## Server Admin Token
64
65You can find the server admin token in /mnt/teamspeak/logs/, search the log
66files for ServerAdmin privilege key created and use that token on first connect.
67
68Alternatively you can run `docker logs <container_id>` which will display    
69the logfile.
70
71
72## Notes on the run command
73
74 + `-v` is the volume you are mounting `-v=host_dir:docker_dir`
75 + `overshard/teamspeak` is simply what I called my docker build of this image
76 + `-d=true` allows this to run cleanly as a daemon, remove for debugging
77 + `-p` is the port it connects to, `-p=host_port:docker_port`
78
79## Major Contributors
80
81 + [overshard][3]
82 + [giant3gg][4]
83
84## Mumble Server Alternative
85
86Benjamin Denhartog has created an alternative [MurMur/Mumble server][2] if you're looking for an alternative to Teamspeak.
87
88[0]: http://www.docker.io/gettingstarted/
89[1]: http://teamspeak.com/
90[2]: https://github.com/bddenhartog/docker-murmur
91[3]: https://github.com/overshard
92[4]: https://github.com/giant3gg
93