sinusbot-docker/README.md
2025-08-02 20:40:33 +02:00

127 lines
4.3 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎧 Sinusbot Docker Setup
Dieses Repository stellt ein vollständig lauffähiges **Docker-Setup für Sinusbot** zur Verfügung.
Ziel ist es, Sinusbot sauber in Containern betreiben zu können **inkl. persistenter Daten**, **Addons** und allem, was man für eine produktive Nutzung braucht.
---
## 🧐 Was ist Sinusbot?
[Sinusbot](https://www.sinusbot.com/) ist ein Musikbot für **Teamspeak 3** und **Discord**, der lokal oder serverseitig betrieben werden kann.
Er streamt Musik (z.B. MP3-Dateien oder Internet-Radios), kann per Webinterface gesteuert werden, unterstützt eine Vielzahl an Scripts zur Automatisierung und lässt sich sehr granular konfigurieren.
Sinusbot eignet sich hervorragend für Gaming-Communities, Clans oder private TS3-Server, um automatisch Musik oder Soundeffekte zu spielen, Nachrichten vorlesen zu lassen (TTS) oder einfache Chat-Automationen umzusetzen.
---
## 🚀 Schnellstart
1. Repository klonen
```bash
git clone https://git.techniverse.net/scriptos/sinusbot-docker.git
```
2. In das Projektverzeichnis wechseln
```bash
cd sinusbot-docker
```
3. Ordnerstruktur erstellen
```bash
mkdir -p ./data/scripts ./data/data
```
4. Schreibrechte anpassen (Benutzer-ID ggf. anpassen)
```bash
chown -R 1000:1000 data
```
5. (Optional) eigenes Docker-Netzwerk anlegen
```bash
docker network create --subnet=172.16.72.0/24 sinusbot.dockernetwork.local
```
👉 **Hinweis:**
Falls du kein eigenes Netzwerk verwenden möchtest, kannst du diesen Schritt überspringen. Du musst allerdings den Abschnitt `networks:` in der `docker-compose.yaml` entsprechend entfernen oder anpassen.
6. Container starten
```bash
docker-compose up -d
```
7. Admin-Kennwort anzeigen lassen (wird nur nach dem ersten Start angezeigt)
```bash
docker-compose logs
```
👉 Im Log erscheint ein Hinweis wie:
```bash
Generating new bot instance with account 'admin' and password '3alMse7m'
PLEASE MAKE SURE TO CHANGE THE PASSWORD DIRECTLY AFTER YOUR FIRST LOGIN!!!
```
---
## 📦 Verfügbare Docker-Tags
Aktuell stehen folgende Tags für das Image zur Verfügung:
- `1.0.2` Feste Version, basiert auf Sinusbot 1.0.2
- `latest` Enthält immer die aktuellste Version dieses Docker-Images (nicht zwingend den neuesten Sinusbot selbst)
👉 Empfohlen wird, für produktive Umgebungen einen festen Tag wie `1.0.2` zu verwenden, um unbeabsichtigte Änderungen durch zukünftige Updates zu vermeiden.
---
## 🎥 asciinema Video
[![asciicast](https://asciinema.techniverse.net/a/62.svg)](https://asciinema.techniverse.net/a/62)
---
## 🔗 Webinterface aufrufen
Nach dem Start erreichst du das Webinterface unter:
```
http://<deine-server-ip>:8087
```
---
Die vollständige Dokumentation zur Einrichtung, zur Teamspeak-Integration, zu Scripts und Addons sowie zum Volume-Handling findest du in der [Dokumentation von Sinusbot](https://sinusbot.github.io/docs/).
---
## 🛠️ Hinweise
- Der Container läuft als Benutzer `1000:1000`. Falls dein Host-System abweicht, bitte entsprechend anpassen.
---
## 📄 Lizenz
Dieses Projekt steht unter der MIT-Lizenz.
Die Nutzung von Sinusbot selbst unterliegt der [FAQ von sinusbot.com](https://sinusbot.github.io/docs/faq/general/).
---
Mit ❤️ von [CleverAdmin.de](https://www.cleveradmin.de)
---
## 💬 Support & Community
Du hast Fragen, brauchst Unterstützung bei der Einrichtung oder möchtest dich einfach mit anderen austauschen, die ähnliche Projekte betreiben? Dann schau gerne in unserer Techniverse Community vorbei:
👉 **Matrix-Raum:** [#community:techniverse.net](https://matrix.to/#/#community:techniverse.net)
Wir freuen uns auf deinen Besuch und helfen dir gerne weiter!
<p align="center">
<img src="https://assets.techniverse.net/f1/git/graphics/gray0-catonline.svg" alt="">
</p>
<p align="center">
<img src="https://assets.techniverse.net/f1/logos/small/license.png" alt="License" width="15" height="15"> <a href="./sinusbot-docker/src/branch/main/LICENSE">License</a> | <img src="https://assets.techniverse.net/f1/logos/small/matrix2.svg" alt="Matrix" width="15" height="15"> <a href="https://matrix.to/#/#community:techniverse.net">Matrix</a> | <img src="https://assets.techniverse.net/f1/logos/small/mastodon2.svg" alt="Matrix" width="15" height="15"> <a href="https://social.techniverse.net/@donnerwolke">Mastodon</a>
</p>