Comment héberger un bot Discord Node.js

Ce guide concerne les bots écrits en Node.js, par exemple avec discord.js.

Configurer le serveur

1. Ouvrez votre serveur dans le panel. Un nouveau serveur de bot démarre comme Node.js Bot : vous n’avez donc pas besoin de changer le type.

2. Ouvrez Files et téléversez votre bot, avec package.json. Ne téléversez pas le dossier node_modules : le serveur l’installe pour vous.

   • Vous préférez git ? Ouvrez Paramètres, puis Paramètres du jeu, et remplissez Dépôt Git (et la branche si vous en avez besoin). Les fichiers sont téléchargés quand le serveur est installé. Pour un dépôt privé, renseignez aussi le nom d’utilisateur git et un jeton d’accès.
3. Dans Paramètres du jeu, réglez Fichier principal sur le fichier qui démarre votre bot, comme index.js ou src/bot.js. Les fichiers en .ts fonctionnent aussi.
4. Collez votre token dans Token du bot Discord (facultatif). Votre code le lit comme process.env.DISCORD_TOKEN.
5. Le serveur utilise Node 22 par défaut. Pour Node 20, 24, 25 ou 26, choisissez-le sous Paramètres, Image Docker, puis redémarrez le serveur.

Le démarrer

Ouvrez Console et démarrez le serveur. À chaque démarrage, le serveur lance npm install quand un package.json existe, puis démarre votre fichier principal. Le premier démarrage est plus long, le temps que les paquets se téléchargent.

Bon à savoir

• Paquets supplémentaires : le champ Paquets npm supplémentaires (facultatif) installe d’autres paquets à chaque démarrage sans modifier package.json.
• Mémoire : Node est limité à 80 pour cent de la mémoire de votre offre, ce qui laisse de la place au reste du processus et évite que le serveur soit arrêté pour consommation excessive.
• TypeScript : un fichier principal en .ts s’exécute directement. Le JavaScript compilé démarre un peu plus vite.
• Mises à jour depuis git : activez Mettre à jour depuis git à chaque démarrage pour récupérer votre dernier code à chaque redémarrage du serveur.

S’il s’arrête tout de suite : lisez Pourquoi votre bot Discord s’arrête sans cesse.