Tutoriel : héberger un bot Discord gratuitement en Python et Node.js
·
Héberger un bot Discord gratuitement, 24h/24 : créer le bot, copier le token, choisir discord.py, discord.js ou TypeScript, envoyer le code et lire les
Pour héberger un bot Discord gratuitement et 24/7, créez le bot sur le Discord Developer Portal, copiez son token, puis déployez votre code discord.py ou discord.js chez un hébergeur de bot Discord gratuit qui le garde allumé à votre place. Chez ACLClouds, l’offre Free fait tourner un bot sans carte bancaire, avec 315 Mo de RAM et un renouvellement gratuit tous les 4 jours : voici chaque étape, de la création du bot à la première commande /hello.
- Le token se copie une seule fois dans l’onglet Bot du Discord Developer Portal.
- Le code lit le token dans la variable DISCORD_TOKEN, jamais en dur dans un fichier.
- L’offre Free ACLClouds héberge 1 bot Node.js ou Python avec 315 Mo de RAM, sans carte bancaire.
- Le renouvellement est gratuit tous les 4 jours, depuis la page du bot.
- Un bot TypeScript compilé tourne en Node.js sur l’offre Free ; Bun et Java demandent une offre payante, dans le même panel.
Créer le bot sur Discord
Ouvrez le Discord Developer Portal, créez une application, puis ouvrez l’onglet Bot. Cliquez sur Reset Token et copiez le token : Discord ne l’affiche qu’une fois. Dans l’onglet OAuth2, cochez les scopes bot et applications.commands, générez le lien d’invitation et ajoutez le bot à votre serveur.
- Le token donne un accès complet au bot : ne le publiez jamais, ni dans le code ni dans une capture.
- Activez Message Content Intent seulement si le bot lit le texte des messages (commandes à préfixe).
- Les commandes slash, comme /hello, n’ont pas besoin de cet intent.
Choisir Python ou Node.js
À la commande de l’offre Free, choisissez l’environnement Node.js pour discord.js ou Python pour discord.py. Le bot démarre avec un projet d’exemple qui répond à /hello : vous vérifiez que tout fonctionne avant d’envoyer votre propre code. La version se change ensuite dans le panel : Node.js 20, 22 ou 24, Python 3.11, 3.12 ou 3.13.
- Node.js : un package.json avec discord.js dans les dépendances et un script start.
- Python : un requirements.txt avec discord.py et le fichier principal, par exemple bot.py.
- Guides détaillés : créer un bot Node.js et héberger un bot Python.
Ajouter le token hors du code
Votre code lit le token dans la variable d’environnement DISCORD_TOKEN : process.env.DISCORD_TOKEN en Node.js, os.environ["DISCORD_TOKEN"] en Python. Si la variable est vide, la console du bot affiche une carte « Token du bot » : collez-y le token, il est enregistré et le bot redémarre. Vous pouvez aussi le saisir dans l’onglet Démarrage.
- Une valeur qui ressemble à l’ID de l’application ou au secret client est signalée avant l’enregistrement.
- Un token collé par erreur dans le champ du nom d’une variable est refusé.
- Plus de détails dans le guide pour ranger les tokens et variables secrètes.
Envoyer votre code
Remplacez le projet d’exemple par le vôtre depuis l’onglet Fichiers ou par SFTP. Chaque bot a son propre accès SFTP, affiché dans l’onglet Paramètres : hôte, port 2222, identifiant et mot de passe, à saisir dans FileZilla ou WinSCP avec le protocole SFTP.
- N’envoyez pas node_modules ni .venv : les dépendances sont installées sur le serveur.
- Un envoi peut atteindre 100 Mo sur l’offre Free.
- Si le fichier de démarrage est introuvable, la console le cherche dans les sous-dossiers et propose de corriger le chemin en un clic.
Démarrer et lire les logs
Lancez le bot depuis la console. Avec le projet d’exemple, la ligne « Logged in as » suivie du nom du bot confirme la connexion à Discord. Tapez ensuite /hello sur votre serveur : une commande globale peut mettre quelques minutes à apparaître la première fois. En cas d’erreur, lisez la première ligne d’erreur de la console, pas la dernière.
- Cannot find module ou ModuleNotFoundError : une dépendance manque dans package.json ou requirements.txt.
- Un bot arrêté de façon inattendue redémarre automatiquement, et les logs restent consultables.
- Bot connecté mais muet : lisez pourquoi un bot Discord passe hors ligne.
Pourquoi choisir ACLClouds pour ce bot
L’offre Free d’hébergement de bot Discord ne met pas le bot en veille et ne demande pas de carte bancaire. Ses limites sont publiques : 1 bot, 315 Mo de RAM, 0,25 vCPU et 715 Mo de stockage. Le renouvellement est gratuit, depuis la page du bot, dans les 2 jours qui précèdent l’échéance.
- Un accès SFTP propre à chaque bot (port 2222), offre gratuite comprise.
- ffmpeg, yt-dlp et deno déjà installés dans les environnements Node.js et Python.
- Un panel en 7 langues, dont le français, l’anglais et l’allemand.
- Une offre payante plus tard, sans changer de panel, quand le bot a besoin de plus de ressources ou d’une base de données.
Et sur un Raspberry Pi, en TypeScript ou en Java ?
Un Raspberry Pi héberge très bien un bot Discord à la maison : installez Node.js ou Python, lancez le bot avec pm2 ou un service systemd et il tourne pour quelques watts. Les limites sont ailleurs : la carte SD s’use, une coupure de courant ou de box met le bot hors ligne, et votre connexion est exposée. Un hébergeur de bot Discord gratuit évite ces pannes, et le code ne change pas : un bot TypeScript compilé en JavaScript tourne en Node.js, et discord.py comme discord.js se mettent à jour avec une ligne dans requirements.txt ou package.json. Bun et Java (JDA) sont proposés sur les offres payantes.
- TypeScript : sur l’offre Free, compilez avec tsc et envoyez le dossier dist en Node.js ; l’environnement Bun, qui exécute les fichiers .ts directement, est proposé sur les offres payantes.
- Intents privilégiés : Message Content, Server Members et Presence doivent être activés sur le Developer Portal avant le démarrage, sinon le bot se ferme avec le code 4014.
- Plan gratuit ou hébergement payant : passez à une offre payante quand le bot dépasse 315 Mo de RAM ou qu’il lui faut une base de données MariaDB.
- Raspberry Pi : gardez-le pour le développement et les tests, et laissez l’hébergeur assurer le 24h/24.
Questions fréquentes
Mon bot reste-t-il en ligne quand mon PC est éteint ?
Oui. Le bot s’exécute sur l’infrastructure ACLClouds, pas sur votre ordinateur. Il suffit de renouveler l’offre Free gratuitement tous les 4 jours depuis la page du bot.
Que se passe-t-il si j’oublie de renouveler ?
Le bot est suspendu à l’échéance. Vous pouvez le renouveler gratuitement depuis sa page une fois suspendu, puis le redémarrer.
Puis-je héberger un bot de musique sur l’offre Free ?
ffmpeg et yt-dlp sont déjà installés, mais la lecture audio consomme de la mémoire et du CPU. Avec 315 Mo de RAM et 0,25 vCPU, testez sur un petit serveur, puis passez à une offre payante si le son coupe.
Combien de bots puis-je héberger gratuitement ?
Un bot par compte sur l’offre Free. Un deuxième bot demande une offre payante, à partir de l’offre Starter.