> ## Documentation Index > Fetch the complete documentation index at: https://www.chapterjs.org/llms.txt > Use this file to discover all available pages before exploring further. # Deploy > Put your bot on a machine that stays on, and keep it running A bot is online as long as `chapterjs start` runs. On your computer it stops when you close the terminal, so a bot for everyone lives on a machine that stays on: a server you rent, a container, a host made for Node applications. Whatever it is, the steps are the same. **1. Put your project there** Clone your repository, or copy the folder without `node_modules` and `.chapterjs` (both are made on the machine). The machine needs [Node.js](https://nodejs.org) 24 or newer and a package manager. **2. Install** Run the install command of your package manager in the folder. The install also writes the types of the project (`postinstall` runs `chapterjs sync`). ```bash pnpm theme={"theme":{"light":"github-light","dark":"vesper"}} pnpm install ``` ```bash npm theme={"theme":{"light":"github-light","dark":"vesper"}} npm install ``` ```bash yarn theme={"theme":{"light":"github-light","dark":"vesper"}} yarn install ``` ```bash bun theme={"theme":{"light":"github-light","dark":"vesper"}} bun install ``` Keep the development dependencies if you want the build to check the types there: without TypeScript, `chapterjs build` says `ℹ Types were not checked` and goes on. **3. Give it the token** Set `BOT_TOKEN` the way the machine does it: an environment variable, the "secrets" of a host, or a `.env` file in the folder. It is the token of your **production** application, not the one of the `.env` on your computer: see [A second bot for development](https://www.chapterjs.org/run/start.md#a-second-bot-for-development). The real environment wins over the file. The token is the only value `chapterjs start` requires. ```bash .env theme={"theme":{"light":"github-light","dark":"vesper"}} BOT_TOKEN= ``` > [!WARNING] > > Never commit `.env`, and never put the token in your code: whoever has it controls your bot. If it leaks, reset it on the **Bot** page of your application in the Developer Portal, and give the new one to the machine. **4. Build** Run the `build` script. It checks every file and compiles the bot into `.chapterjs/build`: see [chapterjs build](https://www.chapterjs.org/run/build.md). ```bash pnpm theme={"theme":{"light":"github-light","dark":"vesper"}} pnpm build ``` ```bash npm theme={"theme":{"light":"github-light","dark":"vesper"}} npm run build ``` ```bash yarn theme={"theme":{"light":"github-light","dark":"vesper"}} yarn build ``` ```bash bun theme={"theme":{"light":"github-light","dark":"vesper"}} bun run build ``` **5. Start** Run the `start` script. The bot is online for everyone: see [chapterjs start](https://www.chapterjs.org/run/start.md). ```bash pnpm theme={"theme":{"light":"github-light","dark":"vesper"}} pnpm start ``` ```bash npm theme={"theme":{"light":"github-light","dark":"vesper"}} npm run start ``` ```bash yarn theme={"theme":{"light":"github-light","dark":"vesper"}} yarn start ``` ```bash bun theme={"theme":{"light":"github-light","dark":"vesper"}} bun start ``` ```text theme={"theme":{"light":"github-light","dark":"vesper"}} ✓ 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 ``` That is all. Many hosts ask for a "build command" and a "start command": give them the `build` and `start` scripts of your project. A host that takes your project from git does the first two steps by itself. > [!NOTE] > > The environment variables and the exit codes of `chapterjs start` are in the [CLI reference](https://www.chapterjs.org/reference/cli.md#chapterjs-start). ## Environment variables | Variable | Required | What it does | | - | - | - | | `BOT_TOKEN` | Yes | The token of your production bot. | | `DEV_GUILD_ID` | No | The ID of your test server. When it is set, production leaves that server alone, so `chapterjs dev` can run the same bot there while this one runs everywhere else. Only for one bot doing both: see [A second bot for development](https://www.chapterjs.org/run/start.md#a-second-bot-for-development). | | `REDIS_URL` | No | The address of your Redis, when a store says `storage: 'redis'`: see [Storage](https://www.chapterjs.org/storage.md#in-redis). Give production its own Redis, not the one of development. | | `REDIS_PASSWORD` | No | Its password, when it is not in `REDIS_URL`. | | `NODE_OPTIONS` | No | Options for Node itself. `--max-old-space-size=4096` gives the bot 4096 MB of memory: only for a large bot, when `chapterjs start` asks for it (see below). | | `NO_COLOR` | No | Set to anything to print without colors. Colors are already off when the output is not a terminal. | Nothing else is read. In particular, there is no option for the intents, the commands or what the bot remembers: all of it comes from your files. ## Keeping it running `chapterjs start` runs until it is stopped. Two things end it: * **A stop asked by the machine** (`Ctrl+C`, a `SIGTERM` from a host or a process manager): the bot disconnects cleanly, prints `✓ Disconnected` and exits with code 0. Give it a few seconds for that before killing it: a bot killed at once stays shown online until Discord notices. * **Something to fix**: a refused token, a privileged intent not enabled, no build, too many sessions started today. The message says what, and the command exits with code 1. Use what the machine offers to start the bot again when it exits, and when the machine reboots: a process manager, the "restart" setting of a host, a system service. Do not restart it blindly in a tight loop: a bot that stops with code 1 has something to fix, and starting it again changes nothing. Discord limits how many times a day a bot can connect; ChapterJS stops before the limit rather than let Discord reset your token: ```text theme={"theme":{"light":"github-light","dark":"vesper"}} ✗ 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. ``` Inside `chapterjs start`, nothing needs your help: the connection is kept alive and reconnected when it drops, and a large bot's processes are started again when one of them stops. ## Updating the bot Put the new files on the machine, build, start again. Until you build, the running bot keeps the previous build, and `chapterjs start` reminds you of it: ```text theme={"theme":{"light":"github-light","dark":"vesper"}} ⚠ Your files changed since the last build: the bot runs the build, not your changes. Run "chapterjs build" to put them online. ``` A build is tied to the version of ChapterJS that made it. After updating the package, build again: ```text theme={"theme":{"light":"github-light","dark":"vesper"}} ✗ This build was made with chapterjs 0.1.3, and this is chapterjs 0.1.4. Run "chapterjs build" again. ``` > [!NOTE] > > If you build on your computer and upload the result, upload `.chapterjs/build` too (it is not in git), and use the same version of ChapterJS and of Node on both sides. The packages the bot uses stay in `node_modules`: production needs them installed. ## Large bots A bot in thousands of servers runs on several processes by itself, one for every 4 shards and never more than the machine has CPUs. Pass `--processes` to choose: ```bash theme={"theme":{"light":"github-light","dark":"vesper"}} chapterjs start --processes 8 ``` Every process runs on the same machine. A machine with more CPUs and more memory is the way to grow; several machines are [not available yet](https://www.chapterjs.org/roadmap.md). The bot adapts what it remembers to the memory it has, and only asks for more when it has nothing left to give up: ```text theme={"theme":{"light":"github-light","dark":"vesper"}} ⚠ 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. ``` What that message means, and what the bot remembers, is in [Memory](https://www.chapterjs.org/memory.md). > [card] [Troubleshooting](https://www.chapterjs.org/run/troubleshooting.md) > > Every message, and what to do about it. > [card] [CLI reference](https://www.chapterjs.org/reference/cli.md) > > Every command, variable and exit code. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.