Vorbereitung

Bevor du den Installations-Befehl ausführst, sorge dafür, dass die folgenden Dinge bereitliegen. Das spart dir Zeit und Frust mitten im Setup — der Installer fragt dich nach allem auf einmal.

1. Server

Du brauchst einen Linux-Server, auf dem VirtueBot rund um die Uhr läuft. Das kann ein gemieteter virtueller Server (VPS) sein oder ein Mini-PC bei dir zu Hause.

Mindest-Anforderungen:

Ubuntu 22.04 oder neuer / Debian 11 oder neuer
4 GB RAM (6 GB empfohlen)
2 Prozessorkerne
10 GB freier Speicher
x86-64-Architektur
Root- oder Sudo-Zugang
Internet-Verbindung

2. Discord-Anwendung

VirtueBot ist ein Discord-Bot — er braucht also eine eigene Anwendung im Discord Developer Portal. Daraus ergeben sich vier Werte, die du vor dem Setup bereithalten musst:

Was	Wo du es findest
Bot-Token	Discord Developer Portal → deine App → Bot → Reset Token
Client-ID	Discord Developer Portal → deine App → General Information → Application ID
Client-Secret	Discord Developer Portal → deine App → OAuth2 → Reset Secret
Bot-Einladungs-Link	Discord Developer Portal → deine App → OAuth2 → URL Generator

Die komplette Schritt-für-Schritt-Anleitung findest du unter Discord-Anwendung anlegen. Du kannst das vor dem Server-Setup machen, das Discord-Portal läuft im Browser.

3. Deine Discord-User-ID

Du bist als Owner dein eigener Super-Admin. Der Installer fragt nach deiner Discord-User-ID, damit er weiß, wer das Webpanel ohne Einladung nutzen darf.

So findest du deine User-ID:

In Discord auf dein Profilbild rechtsklicken → „User-ID kopieren"

Falls die Option nicht erscheint, musst du den Entwicklermodus aktivieren:

Discord-Einstellungen → Erweitert → Entwicklermodus einschalten
Danach auf dein Profilbild rechtsklicken → „User-ID kopieren"

Die ID ist eine lange Zahl, z. B. 199213777428807680. Notiere sie dir.

4. Zugriffsart entscheiden

Bevor du startest, überlege dir, wie du auf das Webpanel zugreifen willst. Der Installer bietet drei Modi an:

a) Nur im Heimnetz (Standard)

Das Webpanel ist nur in deinem lokalen Netzwerk erreichbar. Niemand von außen kommt dran.

✅ Maximale Sicherheit, null Konfigurations-Aufwand
❌ Du kannst von unterwegs nicht aufs Panel zugreifen
❌ Mehrere User aus verschiedenen Netzen geht nicht

Geeignet, wenn: du den Bot allein oder mit Mitbewohnern im selben WLAN nutzt.

b) Cloudflare-Tunnel (empfohlen)

Das Panel ist über eine sichere Cloudflare-Adresse aus dem Internet erreichbar. Du musst keine Ports an deinem Router öffnen.

✅ HTTPS automatisch
✅ Schutz gegen Überlastungs-Angriffe
✅ Funktioniert hinter jedem Router, auch ohne öffentliche IP
✅ Kostenloser Cloudflare-Account reicht

Geeignet, wenn: du von überall zugreifen willst — egal ob mit oder ohne eigene Domain. Der Cloudflare-Tunnel funktioniert in jedem Fall, du musst die Domain nur bei Cloudflare verwalten lassen.

Was du dafür vorher brauchst:

Kostenloser Cloudflare-Account (anmelden unter https://dash.cloudflare.com/sign-up)
Eine Domain, die bei Cloudflare verwaltet wird. Drei Wege dahin:
- Du hast schon eine Domain bei einem anderen Anbieter → bei dem die Nameserver auf Cloudflare umstellen (kostenlos, dauert je nach Anbieter wenige Minuten bis Stunden)
- Du hast schon eine Domain direkt bei Cloudflare gekauft → ist automatisch dort verwaltet
- Du hast noch keine Domain → über den Cloudflare-Registrar eine neue zum Großhandelspreis registrieren (Cloudflare schlägt keine Gebühren auf den Domain-Preis selbst auf)
Einen Tunnel-Token aus dem Cloudflare-Zero-Trust-Dashboard

Die komplette Schritt-für-Schritt-Anleitung — vom Account über die Domain-Anbindung bis zum Tunnel-Token — findest du unter Cloudflare-Tunnel einrichten. Plane dafür ca. 15 Minuten ein.

c) Eigene Domain mit Reverse Proxy

Du hast eine eigene Domain (z. B. virtuebot.deine-seite.de) und Erfahrung mit Server-Konfiguration.

✅ Volle Kontrolle, eigene URL
⚠️ Port-Weiterleitung im Router nötig
⚠️ Caddy oder ein anderer Reverse Proxy muss installiert sein

Geeignet, wenn: du dich mit DNS-Einträgen und Reverse-Proxies auskennst und eine schöne URL haben willst.

Details zu allen drei Modi: Zugriffsmodi.

5. Spotify-Verbindung (optional)

Wenn du Spotify-Links im Bot abspielen können willst (z. B. https://open.spotify.com/track/...), brauchst du kostenlose Spotify-Entwickler-Zugangsdaten. Kein Spotify-Premium nötig, ein normales Spotify-Konto reicht.

Im Setup-Script wirst du nach diesem Punkt gefragt — du kannst Spotify dort auch überspringen. Ohne Spotify funktionieren YouTube-Links, eigene Playlists und Radiosender ganz normal, nur Spotify-Links werden mit einer klaren Meldung abgelehnt.

Was du dafür vorher brauchst:

Ein Spotify-Konto (kostenlos, falls noch keins vorhanden)
Aus dem Spotify-Developer-Dashboard zwei Werte:
- Client ID
- Client Secret

Die komplette Schritt-für-Schritt-Anleitung findest du unter Installation → Spotify einrichten. Du kannst das vor oder nach dem Server-Setup machen.

6. Backup-Strategie

Während des Setups fragt der Installer, ob du automatische tägliche Backups möchtest. Wir empfehlen ja — die Backups landen lokal in /opt/virtuebot/backups/ und kosten dich (bis auf etwas Speicherplatz) nichts.

Bei mehr als drei Discord-Servern oder mehreren Tausend Songs in Playlists solltest du die Backups zusätzlich regelmäßig auf einen externen Speicher kopieren. Wie das geht, steht in Updates einspielen.

Checkliste vor dem Start

Hake der Reihe nach ab:

Server läuft mit Ubuntu 22.04+ oder Debian 11+ und mindestens 4 GB RAM
Du hast SSH- oder Console-Zugang als root oder mit sudo
Discord-App ist im Developer Portal angelegt (siehe Discord-Anwendung anlegen)
Bot-Token, Client-ID, Client-Secret, Einladungs-Link liegen bereit
Deine Discord-User-ID hast du notiert
Du hast entschieden, welchen Zugriffsmodus du nutzt
(Bei Cloudflare-Tunnel) Cloudflare-Account angelegt und Tunnel-Token erzeugt
(Bei eigener Domain) DNS-Eintrag zeigt auf deinen Server, Reverse Proxy ist vorbereitet
(Falls Spotify-Links genutzt werden sollen) Spotify Client ID + Secret liegen bereit

Wenn alle Häkchen gesetzt sind, geht es weiter mit der Installation.