You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+65-23Lines changed: 65 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,32 +12,73 @@
12
12
- Integrated Text-to-Speech engine
13
13
- Compatible with macOS
14
14
15
-
## Installation
15
+
## Disclaimer
16
+
17
+
By using this image you accept the [Privacy statement of the TeamSpeak Systems GmbH](https://www.teamspeak.com/en/privacy-and-terms), the [SinusBot Privacy Policy](https://forum.sinusbot.com/help/privacy-policy/) and SinusBot license agreement.
> This software is free for personal use only. If you want to use it commercially, please contact the author.
22
+
>
23
+
> 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.
24
+
>
25
+
> You may NOT redistribute this software or use this software commercially without prior written permission from the author.
By using this image you accept the [Privacy statement of the TeamSpeak Systems GmbH](https://www.teamspeak.com/en/privacy-and-terms), the [SinusBot Privacy Policy](https://forum.sinusbot.com/help/privacy-policy/) and the license agreement.
31
+
## Installation
18
32
19
33
### docker-compose
20
34
21
35
Download the [docker-compose file](https://github.com/SinusBot/docker/blob/master/docker-compose.yml) in it's own directory and start it with `docker-compose up`.
22
36
23
37
### docker
24
38
39
+
#### root (not recommended)
40
+
25
41
```bash
26
42
docker run -d -p 8087:8087 \
27
43
-v scripts:/opt/sinusbot/scripts \
28
44
-v data:/opt/sinusbot/data \
29
-
--name sinusbot sinusbot/docker
45
+
--name sinusbot \
46
+
sinusbot/docker
30
47
```
31
48
49
+
#### unprivileged user
50
+
32
51
It is recommended that you run the SinusBot as a non-root user, even though the docker container is mostly isolated from the host.
33
52
This can be done as described in the following:
34
53
35
-
- add a new user: `adduser --disabled-login sinusbot`
36
-
- create the required folders if they don't exist: `mkdir -p /opt/sinusbot/data /opt/sinusbot/scripts`
37
-
- give the user permissions to the folders: `chown -R sinusbot:sinusbot /opt/sinusbot`
38
-
- add `-u sinusbot` to the docker run command shown above when you start it
Additional information on [setting the user](https://docs.docker.com/engine/reference/run/#user) or [remapping the user](https://docs.docker.com/engine/security/userns-remap/) can be found in the docker documentation.
62
+
`chown -R sinusbot:sinusbot /opt/sinusbot`
63
+
- Run the docker image with the `UID` and `GID` environment variables set to the correct user- and group-ID as shown below:
64
+
65
+
```bash
66
+
docker run -d -p 8087:8087 \
67
+
-v scripts:/opt/sinusbot/scripts \
68
+
-v data:/opt/sinusbot/data \
69
+
-e UID=$(id -u sinusbot)
70
+
-e GID=$(id -g sinusbot) \
71
+
--name sinusbot \
72
+
sinusbot/docker
73
+
```
74
+
75
+
#### Tags
76
+
77
+
-`latest` is the default tag
78
+
-`discord` is a discord-only version of `latest` and does not contain the TeamSpeak client with additonal dependencies
79
+
- 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`)
80
+
81
+
You view the [full list of tags](https://hub.docker.com/r/sinusbot/docker/tags) for specific versions.
41
82
42
83
## Get Password
43
84
@@ -56,7 +97,7 @@ PLEASE MAKE SURE TO CHANGE THE PASSWORD DIRECTLY AFTER YOUR FIRST LOGIN!!!
56
97
57
98
## Override Password
58
99
59
-
By setting the `OVERRIDE_PASSWORD` environment variable you can override the password of the SinusBot. Usage:
100
+
By setting the `OVERRIDE_PASSWORD` environment variable you can override the password of the SinusBot. Example:
60
101
61
102
```bash
62
103
docker run -d -p 8087:8087 \
@@ -72,18 +113,6 @@ To use your [license](https://sinusbot.github.io/docs/licenses/), which you've g
72
113
73
114
After restarting the container (`docker restart sinusbot`) your licensed instances should appear automatically.
74
115
75
-
## Discord only image
76
-
77
-
There is an image for discord only usage, this won't contain the TeamSpeak client with the additonal dependencies.
78
-
To use it you just have to use the `discord` tag instead of `latest` (default) tag:
79
-
80
-
```bash
81
-
docker run -d -p 8087:8087 \
82
-
-v scripts:/opt/sinusbot/scripts \
83
-
-v data:/opt/sinusbot/data \
84
-
--name sinusbot sinusbot/docker:discord
85
-
```
86
-
87
116
## Updating
88
117
89
118
Docker containers themselves should not store application data, instead the data is stored in volumes (in this case `scripts` and `data`).
@@ -92,8 +121,7 @@ To upgrade a container you need to remove and re-run it as shown below.
92
121
1. Stop and remove the old container.
93
122
94
123
```bash
95
-
docker stop sinusbot
96
-
docker rm sinusbot
124
+
docker stop sinusbot && docker rm sinusbot
97
125
```
98
126
99
127
2. Pull the latest image:
@@ -120,6 +148,20 @@ The Chromium Text-to-Speech engine is pre-installed but disabled by default due
120
148
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`).
121
149
Once it's enabled it can be used by setting the locale to `en-US` or `de-DE` in the instance settings.
0 commit comments