docker-teamspeak

This Project is Deprecated

TeamSpeak now maintain their own official Docker image. My image provides no further benefits, so I defer to the TeamSpeak experts.

To migrate to the official image, see docker-compose-official.yml, which is an equivalent of docker-compose.yml but using the official image.

Deploy the official image by running docker stack deploy:

docker stack deploy teamspeak --compose-file docker-compose-official.yml

Original Outline

A nice and easy way to get a TeamSpeak server up and running using docker. For help on getting started with docker see the official getting started guide. For more information on TeamSpeak and check out its website.

Building docker-teamspeak

Running this will build you the latest docker-teamspeak image:

git clone https://github.com/xanderxaj/docker-teamspeak
cd docker-teamspeak
./ts3-build.sh

Running docker-teamspeak

If nothing else is running on ports 9987, 10011 or 30033, launching TeamSpeak is a simple case of running either:

./ts3-run.sh      # Individual container using `docker run`
./ts3-deploy.sh   # Docker Swarm stack using `docker stack deploy`. May need to run `docker swarm init first`

Note: If you get an error about being unable to gain access to docker, you may need to add yourself to the docker group or prepend sudo to the ts3-* scripts and all docker commands.

If the ports are in use, you can remap them by changing the ports in the teamspeak container's docker run command. Look for -p=9987:9987/udp -p=10011:10011 -p=30033:30033 etc.

You can start and stop TeamSpeak by running:

docker start teamspeak
docker stop teamspeak

The TeamSpeak container will automatically launch on docker daemon startup or relaunch on failure unless it has been stopped; this is via docker's --restart unless-stopped option.

Restricted resource usage

The TeamSpeak container is limited to 100m of RAM and, where supported, 100m of swap. Light testing suggests this is good enough for most personal TS servers (i.e. with less than 20 users). This can be adjusted by modifying the --memory option in ts3-start.sh.

You may get a warning relating to limits on startup, for example:

WARNING: Your kernel does not support swap limit capabilities, memory limited without swap.

This particular message means that RAM usage has been limited but swap has not.

To remove the warnings and enforce the limits, follow the instructions in the Docker docs to enable support in your kernel.

Managing TeamSpeak's data

The TeamSpeak server's data is stored in a named volume called teamspeak.

A backup with the current date and time can be created by running:

./ts3-backup.sh

That backup can be restored with:

./ts3-restore.sh <archiveName>

All data can be erased by deleting the teamspeak named volume; it'll be recreated when you next execute ts3-run.sh:

docker volume rm teamspeak

Server Admin Token

You can find the server admin token by running docker logs teamspeak upon first run of the server. Search for "ServerAdmin privilege key created" and use that token on first connect.

Notes on the run command

-v is the volume you are mounting -v host_dir:docker_dir
teamspeak is the name of the image built by ts3-build.sh
-d allows this to run cleanly as a daemon, remove for debugging
-p is the port it connects to, -p host_port:docker_port

Mumble Server Alternative

Benjamin Denhartog has created an alternative MurMur/Mumble server if you're looking for an alternative to Teamspeak.

xanderxaj / docker-teamspeak Goto Github PK