Einen Discord-Bot auf einem Lordhosting-KVM-VPS installieren

Einen Discord-Bot auf dem eigenen PC zu hosten hat ein offensichtliches Problem: Sobald der Rechner ausgeschaltet wird, geht der Bot offline. Ein KVM-VPS läuft rund um die Uhr und bietet Ihnen eine dedizierte Linux-Umgebung - ideal für einen Node.js-Bot. In dieser Anleitung installieren Sie Node.js, übertragen die Dateien Ihres Bots und halten ihn mit pm2 dauerhaft online, auch nach einem Absturz oder einem Server-Neustart.

Voraussetzungen

• Ein KVM-VPS mit Debian oder Ubuntu, erreichbar per SSH (IP-Adresse und Zugangsdaten finden Sie im Lordhosting-Kundenbereich)
• Ein SSH-Client (Terminal unter Linux/macOS, PowerShell oder PuTTY unter Windows) sowie ein SFTP-Client wie FileZilla oder WinSCP
• Die Dateien Ihres Bots (zum Beispiel meinedatei.js und package.json) sowie dessen Token aus dem Discord-Entwicklerportal

💡 Falls Sie Ihren VPS noch nicht abgesichert haben, folgen Sie zuerst unserer Anleitung Linux-VPS absichern.

1. System aktualisieren

Verbinden Sie sich per SSH mit Ihrem Server:

ssh root@ihre_ip

Aktualisieren Sie anschließend die Paketliste und das System:

sudo apt update && sudo apt upgrade -y

2. Node.js installieren

Installieren Sie Node.js aus dem NodeSource-Repository:

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

Passen Sie 16.x an die von Ihrer Bibliothek benötigte Version an: Aktuelle Versionen von discord.js setzen eine neuere Node.js-LTS-Version voraus. Im Zweifel werfen Sie einen Blick in die package.json Ihres Bots oder in die Dokumentation der Bibliothek.

3. Überprüfen, dass es korrekt installiert ist

node -v
npm -v

Beide Befehle sollten eine Versionsnummer ausgeben. Falls nicht, wiederholen Sie Schritt 2.

4. Bot-Dateien auf den VPS übertragen

Zwei Möglichkeiten:

• SFTP: Verbinden Sie FileZilla oder WinSCP mit denselben Zugangsdaten wie beim SSH (Port 22) und laden Sie den Bot-Ordner hoch, zum Beispiel nach /root/mein-bot.
• Git: Wenn Ihr Code versioniert ist, klonen Sie ihn mit git clone direkt auf den Server.

Laden Sie den Ordner node_modules nicht mit hoch: Er wird im nächsten Schritt auf dem Server neu erzeugt. Achten Sie außerdem darauf, dass Ihr Token nicht fest im Code steht, sondern in einer .env- oder config.json-Datei gespeichert ist.

5. Discord-Bot starten

Wechseln Sie in den Bot-Ordner, installieren Sie die Abhängigkeiten und starten Sie den Bot:

cd /root/mein-bot
npm install
node meinedatei.js

Ihr Bot sollte nun auf Ihrem Discord-Server als online erscheinen. Dieser erste Start ist ein Test: Schließen Sie das Terminal, stoppt der Bot. Der nächste Schritt löst dieses Problem.

6. Bot mit pm2 dauerhaft online halten

pm2 ist ein Prozessmanager für Node.js: Er löst den Bot von Ihrer SSH-Sitzung, startet ihn nach einem Absturz automatisch neu und fährt ihn beim Booten des VPS mit hoch.

sudo npm install -g pm2
pm2 start meinedatei.js --name mein-bot
pm2 startup
pm2 save

Der Befehl pm2 startup gibt eine Zeile aus, die Sie kopieren und ausführen, um den automatischen Start zu aktivieren. Mit pm2 save speichern Sie anschließend die Liste der neu zu startenden Prozesse.

7. Bot verwalten und Logs einsehen

Einige nützliche Befehle für den Alltag:

pm2 status             # Status des Bots
pm2 logs mein-bot      # Logs in Echtzeit
pm2 restart mein-bot   # Neustart nach einem Update
pm2 stop mein-bot      # Bot stoppen

Häufige Probleme

„Error: Cannot find module 'discord.js'": Die Abhängigkeiten sind nicht installiert. Führen Sie npm install in dem Ordner aus, der die Datei package.json enthält - nicht anderswo.

„An invalid token was provided": Der Token in Ihrer .env oder config.json ist falsch oder wurde neu generiert. Erstellen Sie im Discord-Entwicklerportal einen neuen (Tab Bot → Reset Token) und aktualisieren Sie die Datei. Denken Sie auch daran, die Privileged Gateway Intents zu aktivieren, falls Ihr Bot sie benötigt.

Der Bot stoppt, sobald Sie das Terminal schließen: Er wurde direkt mit node gestartet. Starten Sie ihn mit pm2 neu (Schritt 6), um ihn von Ihrer SSH-Sitzung zu lösen.

Ihr Discord-Bot läuft jetzt rund um die Uhr auf Ihrem KVM-VPS, startet nach einem Absturz von selbst neu und übersteht Server-Neustarts. Wenn Sie weitermachen möchten, lesen Sie unsere Anleitung zum Überwachen des Netzwerk-Traffics auf Ihrem VPS.

❗Immer gut zu wissen

• Wenn ein Fehler erscheint oder Ihr Plugin nicht funktioniert, zögern Sie nicht, unseren Support per Ticket oder über Discord zu kontaktieren.