Installation

Diese Anleitung führt dich durch die komplette Installation. Halte dich an die Reihenfolge — der Installer fragt dich nacheinander alles ab, was er braucht.

Voraussetzungen

Bevor du startest, müssen folgende Punkte erfüllt sein:

Linux-Server läuft (Ubuntu 22.04+ oder Debian 11+, mindestens 4 GB RAM)
Du hast Root- oder Sudo-Zugriff
Die fünf Discord-Werte aus Discord-Anwendung anlegen liegen bereit
Du kennst deine Discord-User-ID
Du hast einen Zugriffsmodus gewählt (siehe Zugriffsmodi)

Falls noch etwas fehlt: erst die Vorbereitung abhaken, dann hier weitermachen.

Schritt 1 — Auf den Server einloggen

Verbinde dich per SSH mit deinem Server. Bei einem typischen Mietserver sieht das so aus:

ssh root@<deine-server-adresse>

oder (falls du einen normalen User mit Sudo nutzt):

ssh deinuser@<deine-server-adresse>

Schritt 2 — Erst nur prüfen (optional)

Wenn du vor der echten Installation testen möchtest, ob dein Server geeignet ist, läuft der Installer im Trocken-Modus. Dabei wird nichts verändert — er prüft nur dein System und zeigt, was er tun würde:

curl -fsSL https://get.virtuebot.eu/install.sh | sudo bash -s -- --dry-run

Du siehst eine Liste mit Checks (Speicher, Platz, vorhandene Programme) und Hinweise, falls etwas fehlt. Sobald alle Checks grün sind, geht's mit dem echten Lauf weiter.

Schritt 3 — Installation starten

Der eigentliche Installations-Befehl:

curl -fsSL https://get.virtuebot.eu/install.sh | sudo bash

Der Installer läuft in mehreren Phasen. In Phase 5 stellt er dir Fragen — alle anderen Phasen laufen automatisch.

Phase 1 — System-Check

Es wird geprüft, ob dein Server die Mindest-Anforderungen erfüllt: Betriebssystem, Arbeitsspeicher, Prozessorkerne, freier Platz, Port 3000. Bei kritischen Lücken bricht der Installer ab und sagt dir, was du anpassen musst.

Phase 2 — Konflikt-Check

Es wird geschaut, ob auf deinem Server Reste früherer Installationen oder andere Programme laufen, die stören könnten. Bei Konflikten fragt der Installer nach (z. B. „Port 3000 ist belegt — soll ich Port 3001 nehmen?").

Phase 3 — Bausteine einrichten

Die benötigten Hilfs-Programme (Docker und Docker Compose) werden installiert, falls sie noch fehlen. Bereits installierte Versionen werden nicht angefasst.

Phase 4 — Verzeichnisse anlegen

Unter /opt/virtuebot/ werden die Verzeichnisse für Daten, Konfiguration und Backups erstellt. Ein eigener System-User virtuebot wird angelegt — der Bot läuft also nicht als Root.

Phase 5 — Konfiguration (interaktiv)

Hier fragt dich der Installer nacheinander:

a) Discord-Bot-Token

DISCORD_TOKEN:

→ Den Token aus Schritt 3 im Discord-Setup einfügen und mit Enter bestätigen.

b) Client-ID

DISCORD_CLIENT_ID:

→ Die Application-ID aus Schritt 4 einfügen.

c) Client-Secret

DISCORD_CLIENT_SECRET (OAuth):

→ Den OAuth-Secret aus Schritt 5 einfügen.

d) Deine Discord-User-ID

Discord-User-ID des Owners (Self-Hoster):

→ Deine eigene Discord-ID (eine lange Zahl) eingeben. Wie du sie findest, steht in der Vorbereitung unter Punkt 3.

e) Einladungs-Link

OAUTH_LINK:

→ Der aus Schritt 6 erzeugte Einladungs-Link. Damit kannst du später aus dem Webpanel heraus den Bot zu weiteren Discord-Servern einladen.

Wenn du den Link leer lässt, läuft alles trotzdem — du kannst ihn jederzeit später ergänzen.

f) Spotify-Verbindung (optional)

Spotify-Verbindung (optional):
  Ohne Spotify funktionieren YouTube-Links, eigene Playlists und Radiosender ganz normal.
  Mit Spotify kannst du zusaetzlich Spotify-Links und -Songtitel im Bot oder im Panel
  als Wiedergabe-Quelle nutzen. (Wiedergabe selbst laeuft im Hintergrund ueber YouTube.)

  1) Spotify einrichten (du brauchst kostenlose Spotify-Entwickler-Zugangsdaten)
  2) Spotify weglassen (kannst du jederzeit nachtragen)
Wahl [2]:

→ 2 (Default) lässt den Schritt aus — alles andere funktioniert weiter, nur Spotify-Links werden mit klarer Meldung abgelehnt. 1 führt dich Schritt für Schritt durch die Einrichtung (siehe unten).

Du kannst Spotify auch nach der Installation jederzeit nachtragen — Anleitung in Spotify nachträglich einrichten.

g) Zugriffsmodus

Zugriffsmodus waehlen:
  1) Lokal (nur im LAN erreichbar) — Default
  2) Cloudflare-Tunnel (per Tunnel-Token aus dem Cloudflare-Dashboard)
  3) Reverse Proxy mit eigener Domain (manuelles Caddy-Setup)
Wahl [1]:

→ 1, 2 oder 3 eingeben. Im Detail siehe Zugriffsmodi.

Bei Auswahl 2 (Cloudflare-Tunnel):

Cloudflare-Tunnel-Token:

→ Der Tunnel-Token aus dem Cloudflare-Dashboard. Wie du ihn anlegst, steht in Cloudflare-Tunnel einrichten.

Public-URL des Tunnels (z. B. https://app.virtuebot.eu):

→ Die öffentliche Adresse, unter der dein Panel erreichbar sein soll (die du in Cloudflare festgelegt hast).

Bei Auswahl 3 (Reverse Proxy):

Eigene Domain (z. B. virtuebot.example.com):

→ Deine Domain ohne https:// und ohne abschließenden Schrägstrich. Details in Eigene Domain mit Reverse Proxy.

h) Automatische Backups

Taegliche automatische Backups einrichten? [y/N]:

→ Wir empfehlen y (also „yes" eingeben). Die Backups landen in /opt/virtuebot/backups/.

Phase 6 — Stack einrichten

Der Installer schreibt die Konfigurationsdatei und installiert das Kommandozeilen-Werkzeug virtuebot. Damit steuerst du den Bot später von der Konsole aus (siehe Phase 8).

Phase 7 — Start

Der Bot und das Webpanel werden heruntergeladen und gestartet. Das kann beim ersten Mal 1–3 Minuten dauern. Der Installer wartet, bis VirtueBot antwortet (maximal 60 Sekunden).

Phase 8 — Übersicht

Am Ende siehst du eine Zusammenfassung:

VirtueBot ist installiert.

  Panel:      http://localhost:3000      (oder deine Tunnel-/Domain-URL)
  Daten:      /opt/virtuebot/data
  Konfig:     /opt/virtuebot/.env
  CLI:        /usr/local/bin/virtuebot

  Befehle:
    virtuebot status     - Container-Status + RAM/CPU
    virtuebot logs       - letzte 100 Log-Zeilen
    virtuebot restart    - neu starten
    virtuebot update     - auf neueste Version aktualisieren
    virtuebot backup     - Datensicherung erstellen
    virtuebot uninstall  - Setup rückgängig machen

Schritt 4 — Erste Anmeldung

Öffne im Browser die Panel-Adresse aus Phase 8.
Klick auf „Anmelden" und melde dich mit demselben Discord-Account an, dessen User-ID du beim Setup hinterlegt hast.
Du landest auf deiner Übersicht.

Wenn das klappt, ist die Installation abgeschlossen.

Schritt 5 — Bot zu deinem Discord-Server einladen

Falls du den Bot noch nicht eingeladen hast (Schritt 8 im Discord-Setup):

Im Panel oben rechts auf „Bot einladen" klicken (sichtbar, wenn du den Einladungs-Link beim Setup hinterlegt hast).
Im Discord-Dropdown deinen Server wählen → „Authorize".

Der Bot erscheint dann in deinem Discord-Server und ist sofort einsatzbereit.

Erste Aktionen

Wir empfehlen für den Start:

Weitere Personen einladen — siehe Berechtigungen & User einladen, wenn du das Panel mit anderen teilen willst.
Musik testen — geh in einen Voice-Channel und probier im Panel oder per Discord-Slash-Befehl /play <Song> aus.
Lizenz aktivieren (optional) — im Panel unter Globale Einstellungen → Lizenz, falls du den Bot auf mehreren Discord-Servern nutzen willst.

Wenn etwas nicht funktioniert

Der Installer zeigt klare Fehlermeldungen — die meisten kommen von fehlenden Voraussetzungen.
Logs ansehen: virtuebot logs
Wenn etwas nicht startet: virtuebot status
Falls gar nichts geht: siehe Troubleshooting.

Spotify einrichten — Schritt für Schritt

Wenn du im Setup 1 gewählt hast (oder es jetzt nachholen willst), brauchst du kostenlose Spotify-Entwickler-Zugangsdaten. Kein Spotify-Premium nötig, ein normales Konto reicht.

Öffne im Browser https://developer.spotify.com/dashboard und melde dich mit deinem Spotify-Konto an. Falls du keins hast: kostenlos erstellen.
Klicke auf „Create app".
Vergib einen Namen (z. B. VirtueBot) und eine kurze Beschreibung. Beides sieht nur du.
Bei „Redirect URI" trage etwas Beliebiges ein, z. B. http://localhost. Wir verwenden das Feld nicht, es muss aber ausgefüllt sein.
Akzeptiere die Bedingungen und klicke „Save".
Auf der App-Seite siehst du jetzt „Client ID" und einen Knopf „View client secret". Beide Werte brauchst du gleich.
Im Setup-Script wirst du dann gefragt:
```
Spotify Client ID:
Spotify Client Secret:
```
Beide Werte aus dem Spotify-Dashboard reinkopieren — fertig.

Spotify nachträglich einrichten

Wenn du Spotify übersprungen hast und doch hinzufügen möchtest:

Hol dir die Spotify-Zugangsdaten wie oben beschrieben (Schritte 1–6).
Öffne /opt/virtuebot/.env auf deinem Server (z. B. sudo nano /opt/virtuebot/.env).

Trage am Ende ein:

SPOTIFY_CLIENT_ID=deine-client-id
SPOTIFY_CLIENT_SECRET=dein-client-secret

Speichern, schließen, dann den Bot neu starten:
```
virtuebot restart
```

Spotify-Links funktionieren ab dem Neustart sofort.

Mehrfach ausführen

Du kannst den Installations-Befehl beliebig oft erneut starten. Bestehende Daten und Konfiguration werden nicht überschrieben — fehlende Bausteine werden ergänzt. Das macht ihn zum sicheren Reparatur-Werkzeug, falls dir später etwas verloren geht.