Inhalt
Node.js-Version wählen
Unter Bot › Bot-Einstellungen wählst du die Version: Node.js 22 und 24 (LTS) sowie 25 und 26. Welche Version deine Bibliothek verlangt, steht in ihrer Dokumentation. Nach dem Wechsel startest du den Bot neu.

Was beim Start passiert
Bei jedem Start arbeitet der Server diese Schritte der Reihe nach ab:
- Ist ein Git-Repository verbunden und Automatisch aktualisieren auf 1 gesetzt, holt er zuerst den neuesten Stand mit git pull.
- Pakete aus dem Feld Zusätzliche Pakete (zum Beispiel dotenv axios) installiert npm.
- Pakete aus dem Feld Pakete entfernen löscht npm mit npm uninstall.
- Gibt es eine package.json, läuft npm install, ohne die Hinweise zu Förderung und Sicherheitsprüfung auszugeben.
- Fehlt die Startdatei, bleibt der Server an und meldet „Startdatei … nicht gefunden“. Sonst startet node die Datei mit den Zusätzlichen Startparametern.
package.json und Abhängigkeiten
- Trage discord.js unter dependencies ein, so wie es der Beispiel-Bot mit
"discord.js": "^14.16.0"tut. - Lass den Ordner node_modules beim Hochladen weg, die Pakete entstehen auf dem Server.
- Pakete, die nicht in der package.json stehen sollen, trägst du unter Zusätzliche Pakete ein. Sie werden bei jedem Start installiert.
- Die Zusätzlichen Startparameter gibst du ohne node und ohne Dateinamen ein. Dein Code liest sie aus process.argv.
Startdatei und ES-Module
- Die Startdatei (Standard: index.js) trägst du in den Bot-Einstellungen ein, auch mit Ordner, zum Beispiel src/index.js.
- ES-Module (import statt require) funktionieren, wenn in deiner package.json
"type": "module"steht oder die Datei auf .mjs endet.
TypeScript ohne Build-Schritt
Endet die Startdatei auf .ts, startet der Server sie mit tsx, ohne dass du vorher kompilierst. Ist tsx im Laufzeit-Image nicht vorhanden, lädt der Server es beim Start über npx. Alternativ kompilierst du selbst (zum Beispiel nach dist/index.js) und trägst die JavaScript-Datei als Startdatei ein.
Bun statt Node.js
Wählst du bei der Bestellung oder unter Verwaltung › Allgemein die Software Discord-Bot (Bun), läuft dein Bot mit Bun. Bei jedem Start installiert bun install die Pakete aus der package.json, und bun run startet die Startdatei, auch eine .ts-Datei. Der Beispiel-Bot mit discord.js läuft unter Bun unverändert.
Der Token in discord.js
Melde den Bot mit client.login(process.env.DISCORD_TOKEN) an und trage den Token im Feld Discord-Bot-Token ein, siehe Bot-Token eintragen. Der Wert steht in process.env, auch ohne dotenv und ohne .env-Datei.
Der Beispiel-Bot mit discord.js
Nach der Bestellung liegt ein Beispiel-Bot bereit (index.js und package.json mit discord.js 14). Er fordert nur den Intent Guilds an, registriert nach dem Start den Befehl /ping und antwortet mit der Latenz.
In der Konsole siehst du „Bot ist online als …“ und „Befehl /ping ist registriert.“. Fehlt der Token, meldet der Beispiel-Bot „Kein Bot-Token gesetzt“ und bleibt aktiv, bis du ihn einträgst. Schlägt die Anmeldung fehl, steht dort „Anmeldung bei Discord fehlgeschlagen“ mit der Meldung von discord.js. Wechselst du auf ein Git-Repository, legt der Server den Beispiel-Bot im Ordner beispiel-bot-alt ab.
Typische Meldungen bei Node.js
- Cannot find module 'xyz': Das Paket fehlt in der package.json, oder ein relativer Pfad in require oder import stimmt nicht.
- Startdatei … nicht gefunden: Dateiname oder Ordner in den Bot-Einstellungen passen nicht zu dem, was unter Dateien liegt.
- An invalid token was provided: Der Token ist falsch oder wurde im Developer Portal zurückgesetzt.
- Used disallowed intents: Dein Code fordert einen Intent an, der im Developer Portal nicht eingeschaltet ist.
Fertige Vorlage auf GitHub
Als Ausgangspunkt gibt es eine freie Vorlage für Node.js (discord.js): discord-bot-starter-nodejs. Sie enthält Slash-Befehle, Beispielbefehle, ein Dockerfile und eine ausführliche Anleitung auf Deutsch (MIT-Lizenz). Du kannst sie auch ohne VentroHosting nutzen.
Häufige Fragen
Mein Bot meldet „Cannot find module“. Was tun?
Das Paket fehlt in deiner package.json. Trage es dort unter dependencies ein oder in den Bot-Einstellungen bei „Zusätzliche Pakete“ und starte neu.
Was ändert sich mit Bun statt Node.js?
Statt npm install läuft bun install, und bun run startet die Startdatei. TypeScript-Dateien brauchen dabei kein tsx. Pakete und Startdatei trägst du wie bei Node.js ein.
Kann ich meinen Bot in TypeScript schreiben?
Ja. Trägst du eine Datei mit der Endung .ts als Startdatei ein, startet der Server sie mit tsx, ohne dass du vorher kompilierst.
Unsere Empfehlung: Bot Plus
1 GB RAM für 2,99 € pro 30 Tage, ohne Abo. Nach der Bezahlung wird der Server automatisch eingerichtet.