Skip to content
Official Docker image of the SinusBot for TeamSpeak 3 and Discord.
Shell Dockerfile
Branch: master
Clone or download
Latest commit f5c72c6 Oct 2, 2019

README.md

SinusBot Docker image

Docker Automated build Docker Build Status Docker Pulls Image Info

Features

  • Easy Updateable
  • Minimal dependencies to the Host system
  • Integrated Text-to-Speech engine
  • Compatible with macOS

Disclaimer

By using this image you accept the Privacy statement of the TeamSpeak Systems GmbH, the SinusBot Privacy Policy and SinusBot license agreement.

© 2013-2019 Michael Friese. All rights reserved. (https://www.sinusbot.com)

This software is free for personal use only. If you want to use it commercially, please contact the author.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

You may NOT redistribute this software or use this software commercially without prior written permission from the author.

TeamSpeak 3 is © TeamSpeak Systems GmbH. This product and the author is in no way affiliated with TeamSpeak Systems GmbH.

Discord is © Hammer & Chisel Inc. This product and the author is in no way affiliated with Hammer & Chisel Inc.

Installation

docker-compose

Download the docker-compose file in it's own directory and start it with docker-compose up.

docker

root (not recommended)

docker run -d -p 8087:8087 \
           -v scripts:/opt/sinusbot/scripts \
           -v data:/opt/sinusbot/data \
           --name sinusbot \
           sinusbot/docker

unprivileged user

It is recommended that you run the SinusBot as a non-root user, even though the docker container is mostly isolated from the host. This can be done as described in the following:

  • add a new user:

    useradd --no-create-home -s /sbin/nologin -U sinusbot

  • create the required folders if they don't exist:

    mkdir -p /opt/sinusbot/data /opt/sinusbot/scripts

  • give the user permissions to the folders:

    chown -R sinusbot:sinusbot /opt/sinusbot

  • Run the docker image with the UID and GID environment variables set to the correct user- and group-ID as shown below:

    docker run -d -p 8087:8087 \
               -v scripts:/opt/sinusbot/scripts \
               -v data:/opt/sinusbot/data \
               -e UID=$(id -u sinusbot) \
               -e GID=$(id -g sinusbot) \
               --name sinusbot \
               sinusbot/docker

Tags

  • latest is the default tag
  • discord is a discord-only version of latest and does not contain the TeamSpeak client with additonal dependencies
  • every release is tagged with it's version (for example: 1.0.0-beta.6-f290553) and a discord-only tag (for example: 1.0.0-beta.6-f290553-discord)

You view the full list of tags for specific versions.

Get Password

After starting the SinusBot docker image with docker run an ID will be returned in the next line. Use the command docker logs sinusbot to print out the logs of the container. The beginning of the log should contain your credentials:

[...]
-------------------------------------------------------------------------------
Generating new bot instance with account 'admin' and password 'YOUR_PASSWORD_HERE'
PLEASE MAKE SURE TO CHANGE THE PASSWORD DIRECTLY AFTER YOUR FIRST LOGIN!!!
-------------------------------------------------------------------------------
[...]

Override Password

By setting the OVERRIDE_PASSWORD environment variable you can override the password of the SinusBot. Example:

docker run -d -p 8087:8087 \
           -v scripts:/opt/sinusbot/scripts \
           -v data:/opt/sinusbot/data \
           -e OVERRIDE_PASSWORD=foobar \
           --name sinusbot sinusbot/docker

License

To use your license, which you've got from the License Page in the Forum, you need to save the private.dat into the data folder.

After restarting the container (docker restart sinusbot) your licensed instances should appear automatically.

Updating

Docker containers themselves should not store application data, instead the data is stored in volumes (in this case scripts and data). To upgrade a container you need to remove and re-run it as shown below.

  1. Stop and remove the old container.

    docker stop sinusbot && docker rm sinusbot
  2. Pull the latest image:

    docker pull sinusbot/docker
  3. Create a new container with your volumes.

    docker run --rm -d -p 8087:8087 \
              -v scripts:/opt/sinusbot/scripts \
              -v data:/opt/sinusbot/data \
              --name sinusbot sinusbot/docker

It is also possible to automate this process by running Watchtower.

Text-to-Speech

The Chromium Text-to-Speech engine is pre-installed but disabled by default due to higher cpu/memory usage.

To enable it you simply need to set the TTS.Enabled property to true in the config.ini stored in the data volume (/opt/sinusbot/data) and restart your container (docker restart sinusbot). Once it's enabled it can be used by setting the locale to en-US or de-DE in the instance settings.

Discord only image

Image Info

There is an image for discord only usage, this won't contain the TeamSpeak client with the additonal dependencies. To use it you just have to use the discord tag instead of latest (default) tag:

docker run -d -p 8087:8087 \
           -v scripts:/opt/sinusbot/scripts \
           -v data:/opt/sinusbot/data \
           --name sinusbot sinusbot/docker:discord

Other Docker registries

QUAY

Docker Repository on Quay

Can be pulled by using:

docker pull quay.io/sinusbot/docker

For using docker-compose with quay.io just replace sinusbot/docker with quay.io/sinusbot/docker. Example:

# docker-compose.yml
sinusbot:
  image: quay.io/sinusbot/docker
  restart: always
  ports:
    - 8087:8087
  volumes:
    - ./scripts:/opt/sinusbot/scripts
    - ./data:/opt/sinusbot/data

docker-compose with TeamSpeak 3 Server

In the SinusBot you have to use the network alias teamspeak.docker.local as hostname.

# docker-compose.yml
version: '2'
services:
  teamspeak:
    image: teamspeak
    restart: always
    ports:
      - 9987:9987/udp
      - 10011:10011
      - 30033:30033
    environment:
      TS3SERVER_LICENSE: accept
    networks:
      mynetwork:
        aliases:
          - teamspeak.docker.local

  sinusbot:
    image: sinusbot/docker
    restart: always
    ports:
      - 8087:8087
    volumes:
      - ./scripts:/opt/sinusbot/scripts
      - ./data:/opt/sinusbot/data
    networks:
     - mynetwork
networks:
    mynetwork:
        driver: bridge
You can’t perform that action at this time.