Cómo alojar un bot de Discord en Node.js

Esta guía es para bots escritos en Node.js, por ejemplo con discord.js.

Configura el servidor

1. Abre tu servidor en el panel. Un servidor de bot nuevo empieza como Node.js Bot, así que no necesitas cambiar el tipo.

2. Abre Files y sube tu bot, incluido package.json. No subas la carpeta node_modules, el servidor la instala por ti.

   • ¿Prefieres usar git? Abre Ajustes, luego Ajustes del juego, y rellena Git repository (repositorio git) y la rama si necesitas una. Los archivos se descargan cuando se instala el servidor. Para un repositorio privado indica también el usuario de git y un token de acceso.
3. En Ajustes del juego, indica en Main file (archivo principal) el archivo que inicia tu bot, como index.js o src/bot.js. Los archivos que terminan en .ts también funcionan.
4. Pega tu token en Discord bot token (optional) (token del bot de Discord, opcional). Tu código lo lee como process.env.DISCORD_TOKEN.
5. El servidor usa Node 22 por defecto. Para Node 20, 24, 25 o 26, elígelo en Ajustes, Imagen de Docker, y reinicia el servidor.

Inícialo

Abre Console e inicia el servidor. En cada inicio, el servidor ejecuta npm install cuando existe un package.json y luego inicia tu archivo principal. El primer inicio tarda más mientras se descargan los paquetes.

Conviene saber

• Paquetes extra: el campo Extra npm packages (paquetes npm extra) instala más paquetes en cada inicio sin editar package.json.
• Memoria: Node está limitado al 80 por ciento de la memoria de tu plan, lo que deja espacio para el resto del proceso y evita que el servidor se detenga por usar demasiada.
• TypeScript: un archivo principal .ts se ejecuta directamente. El JavaScript compilado arranca algo más rápido.
• Actualizaciones desde git: activa Update from git on every start (actualizar desde git en cada inicio) para traer tu código más reciente cada vez que se reinicia el servidor.

Si se detiene enseguida: lee Por qué tu bot de Discord se sigue deteniendo.