Déployer

Un bot est en ligne tant que chapterjs start tourne. Sur votre ordinateur, il s’arrête quand vous fermez le terminal, donc un bot pour tout le monde vit sur une machine qui reste allumée : un serveur que vous louez, un conteneur, un hébergeur fait pour les applications Node. Quelle qu’elle soit, les étapes sont les mêmes.

Y mettre votre projet

Clonez votre dépôt, ou copiez le dossier sans node_modules ni .chapterjs (les deux sont recréés sur la machine). La machine a besoin de Node.js 24 ou plus récent et d’un gestionnaire de paquets.

Installer

Lancez la commande d’installation de votre gestionnaire de paquets dans le dossier. L’installation écrit aussi les types du projet (postinstall lance chapterjs sync).

pnpm install

npm install

yarn install

bun install

Gardez les dépendances de développement si vous voulez que la compilation vérifie les types là-bas : sans TypeScript, chapterjs build dit ℹ Types were not checked et continue.

Lui donner le token

Réglez BOT_TOKEN comme le fait la machine : une variable d’environnement, les « secrets » d’un hébergeur, ou un fichier .env dans le dossier. C’est le token de votre application de production, pas celui du .env de votre ordinateur : voir Un second bot pour le développement. Le vrai environnement l’emporte sur le fichier. Le token est la seule valeur qu’exige chapterjs start.

.env

BOT_TOKEN=

Ne commitez jamais .env, et ne mettez jamais le token dans votre code : qui le possède contrôle votre bot. S’il fuit, réinitialisez-le sur la page Bot de votre application dans le Developer Portal, et donnez le nouveau à la machine.

Compiler

Lancez le script build. Il vérifie chaque fichier et compile le bot dans .chapterjs/build : voir chapterjs build.

pnpm build

npm run build

yarn build

bun run build

Lancer

Lancez le script start. Le bot est en ligne pour tout le monde : voir chapterjs start.

pnpm start

npm run start

yarn start

bun start

✓ Commands updated for everyone
✓ Online as my-bot in 128 servers
ℹ Intents computed from your files: GUILDS, GUILD_MESSAGES, MESSAGE_CONTENT
✓ 4 commands, 6 events loaded

C’est tout. Beaucoup d’hébergeurs demandent une « build command » et une « start command » : donnez-leur les scripts build et start de votre projet. Un hébergeur qui récupère votre projet depuis git fait les deux premières étapes tout seul.

Les variables d’environnement et les codes de sortie de chapterjs start sont dans la référence du CLI.

Variables d’environnement

Variable	Obligatoire	Ce qu’elle fait
`BOT_TOKEN`	Oui	Le token de votre bot de production.
`DEV_GUILD_ID`	Non	L’identifiant de votre serveur de test. Quand il est réglé, la production laisse ce serveur tranquille, pour que `chapterjs dev` puisse y faire tourner le même bot pendant que celui-ci tourne partout ailleurs. Seulement pour un bot qui fait les deux : voir Un second bot pour le développement.
`REDIS_URL`	Non	L’adresse de votre Redis, quand un store dit `storage: 'redis'` : voir Stockage. Donnez à la production son propre Redis, pas celui du développement.
`REDIS_PASSWORD`	Non	Son mot de passe, quand il n’est pas dans `REDIS_URL`.
`NODE_OPTIONS`	Non	Des options pour Node lui-même. `--max-old-space-size=4096` donne 4096 MB de mémoire au bot : seulement pour un gros bot, quand `chapterjs start` le demande (voir plus bas).
`NO_COLOR`	Non	Réglez-la sur n’importe quoi pour afficher sans couleurs. Les couleurs sont déjà coupées quand la sortie n’est pas un terminal.

Rien d’autre n’est lu. En particulier, il n’y a aucune option pour les intents, les commandes ou ce dont le bot se souvient : tout cela vient de vos fichiers.

Le garder en marche

chapterjs start tourne jusqu’à ce qu’on l’arrête. Deux choses le terminent :

Un arrêt demandé par la machine (Ctrl+C, un SIGTERM d’un hébergeur ou d’un gestionnaire de processus) : le bot se déconnecte proprement, affiche ✓ Disconnected et sort avec le code 0. Laissez-lui quelques secondes pour cela avant de le tuer : un bot tué d’un coup reste affiché en ligne jusqu’à ce que Discord le remarque.
Quelque chose à corriger : un token refusé, un intent privilégié non activé, pas de compilation, trop de sessions démarrées aujourd’hui. Le message dit quoi, et la commande sort avec le code 1.

Utilisez ce que propose la machine pour relancer le bot quand il s’arrête, et quand la machine redémarre : un gestionnaire de processus, le réglage « restart » d’un hébergeur, un service système. Ne le relancez pas aveuglément en boucle serrée : un bot qui s’arrête avec le code 1 a quelque chose à corriger, et le relancer ne change rien. Discord limite le nombre de connexions d’un bot par jour ; ChapterJS s’arrête avant la limite plutôt que de laisser Discord réinitialiser votre token :

✗ The bot needs to start 1 session(s) but Discord only allows 0 more until 10/7/2026, 9:00:00 AM. Going over that limit makes Discord reset the bot token, so the bot is not started. This usually means it was restarted too many times: wait, then start it again.

À l’intérieur de chapterjs start, rien n’a besoin de votre aide : la connexion est gardée en vie et rétablie quand elle tombe, et les processus d’un gros bot sont relancés quand l’un d’eux s’arrête.

Mettre le bot à jour

Mettez les nouveaux fichiers sur la machine, compilez, relancez. Tant que vous ne compilez pas, le bot en marche garde la compilation précédente, et chapterjs start vous le rappelle :

⚠ Your files changed since the last build: the bot runs the build, not your changes. Run "chapterjs build" to put them online.

Une compilation est liée à la version de ChapterJS qui l’a faite. Après avoir mis à jour le paquet, recompilez :

✗ This build was made with chapterjs 0.1.3, and this is chapterjs 0.1.4.
  Run "chapterjs build" again.

Si vous compilez sur votre ordinateur et envoyez le résultat, envoyez aussi .chapterjs/build (il n’est pas dans git), et utilisez la même version de ChapterJS et de Node des deux côtés. Les paquets qu’utilise le bot restent dans node_modules : la production en a besoin, installés.

Gros bots

Un bot présent dans des milliers de serveurs tourne tout seul sur plusieurs processus, un pour 4 shards et jamais plus que la machine n’a de processeurs. Passez --processes pour choisir :

chapterjs start --processes 8

Chaque processus tourne sur la même machine. Une machine avec plus de processeurs et plus de mémoire est le moyen de grandir ; plusieurs machines ne sont pas encore disponibles. Le bot adapte ce dont il se souvient à la mémoire qu’il a, et ne demande plus de mémoire que quand il n’a plus rien à céder :

⚠ The bot uses 1900 MB of the 2048 MB of memory it can use, and already remembers as little as it can: 18420 servers and 240000 channels, which it needs. Remembering less freed 12 MB. If your own code keeps things that only grow (a list, a Map), that is what fills it: look there first. Otherwise give the bot more memory: set NODE_OPTIONS=--max-old-space-size=4096 (in MB) on a machine that has that much.

Ce que veut dire ce message, et ce dont le bot se souvient, est dans Mémoire.

Dépannage

Chaque message, et quoi en faire.

Référence du CLI

Chaque commande, variable et code de sortie.

Bien démarrer

Commandes

Messages

Événements

Vocal

Composants

Tâches

Présence

Stockage

Traductions

Mémoire

Tests

Faire tourner votre bot

Roadmap

Variables d’environnement

Le garder en marche

Mettre le bot à jour

Gros bots

Dépannage

Référence du CLI