Como hospedar um bot do Discord em Node.js

Este guia é para bots escritos em Node.js, por exemplo com discord.js.

Configure o servidor

1. Abra o seu servidor no painel. Um servidor de bot novo começa como Node.js Bot, então você não precisa mudar o tipo.

2. Abra Files e envie o seu bot, incluindo o package.json. Não envie a pasta node_modules, o servidor a instala para você.

   • Prefere usar git? Abra Configurações, depois Configurações do jogo, e preencha Git repository (e a branch, se precisar de uma). Os arquivos são baixados quando o servidor é instalado. Para um repositório privado, defina também o usuário do git e um token de acesso.
3. Em Configurações do jogo, defina Main file (arquivo principal) como o arquivo que inicia o seu bot, como index.js ou src/bot.js. Arquivos terminados em .ts também funcionam.
4. Cole o seu token em Discord bot token (optional) (token do bot do Discord, opcional). O seu código o lê como process.env.DISCORD_TOKEN.
5. O servidor usa o Node 22 por padrão. Para o Node 20, 24, 25 ou 26, escolha em Configurações, Imagem Docker, e reinicie o servidor.

Inicie

Abra o Console e inicie o servidor. A cada inicialização o servidor executa npm install quando existe um package.json e depois inicia o seu arquivo principal. A primeira inicialização demora mais enquanto os pacotes são baixados.

Bom saber

• Pacotes extras: o campo Extra npm packages instala mais pacotes a cada inicialização, sem você precisar editar o package.json.
• Memória: o Node é limitado a 80 por cento da memória do seu plano, o que deixa espaço para o resto do processo e evita que o servidor seja parado por usar demais.
• TypeScript: um arquivo principal .ts roda diretamente. O JavaScript compilado inicia um pouco mais rápido.
• Atualizações pelo git: ative Update from git on every start para baixar o seu código mais recente toda vez que o servidor reiniciar.

Se ele parar logo: leia Por que o seu bot do Discord para toda hora.