Discord Bot Crash & Exit Code Troubleshooting Guide

Most Discord bot crashes on Pterodactyl are caused by: Exit Code 137 (Out of Memory / RAM limit exceeded), Exit Code 1 (Unhandled Promise Rejection or Syntax Error), Disallowed Intents (Missing developer portal intents), or Exit Code 4004 (Invalid Bot Token). Inspect the Pterodactyl Web Console stdout logs to identify the exact stack trace.

---

Common Exit Codes & How to Fix Them

1. Exit Code 137: Out of Memory (OOM Killed)

• Symptom: The container panel status changes to Offline (Crashed) with Container killed by OOM killer or Exit Code 137.
• Cause: Your bot attempted to consume more RAM memory than allocated by your container plan. Common triggers include caching large user/guild arrays in memory or memory leaks.
• Fix:
  1. Inspect memory usage graphs in the Console tab.
  2. Disable unused gateway cache intents in discord.js (e.g., GatewayIntentBits.GuildMembers or GuildPresences).
  3. Upgrade your plan to a higher RAM tier (e.g., from 256 MB to 512 MB or 1 GB) on Paid Discord Hosting.

---

2. Exit Code 1 / MODULE_NOT_FOUND Error

• Symptom: Console outputs Error: Cannot find module 'discord.js' or ModuleNotFoundError: No module named 'requests'.
• Cause: Required library dependencies are missing from package.json or requirements.txt.
• Fix:
  • For Node.js: Run npm install <package-name> in the Pterodactyl console or update package.json and restart.
  • For Python: Add the missing package to requirements.txt in the Files tab and restart.

---

3. Exit Code 4004 / An invalid token was provided

• Symptom: Bot attempts to connect to Discord WebSocket gateway and immediately disconnects.
• Cause: Incorrect, reset, or malformed BOT_TOKEN string.
• Fix:
  1. Reset your bot token at Discord Developer Portal.
  2. Open the Startup tab in Pterodactyl panel.
  3. Update your BOT_TOKEN variable without extra quotes or spaces.

---

4. DisallowedIntentsException / Code 4014

• Symptom: Bot crashes with [DISALLOWED_INTENTS]: Privileged intent provided is not enabled.
• Cause: Your code requests privileged intents (Message Content, Server Members, or Presences) that are disabled in the Discord Developer Portal.
• Fix:
  1. Open Discord Developer Portal.
  2. Click your Application ➔ Bot tab.
  3. Scroll down to Privileged Gateway Intents and enable Message Content Intent and Server Members Intent.

---

How to Enable Automated Crash Restarts in Pterodactyl

VisiHost containers include automated health monitoring:

1. If your process crashes due to an unhandled exception, our Pterodactyl daemon automatically restarts your bot within seconds.
2. If your bot enters a rapid crash loop (crashing more than 10 times in 60 seconds), the daemon pauses restarts to prevent resource exhaustion.
3. Fix the underlying code syntax or token error, then click Start manually in the Console tab.

---

Related Guides & Resources

• Check RAM and vCPU recommendations in Discord Bot RAM & CPU Requirements.
• Learn deployment steps for discord.js or discord.py.
• Upgrade to dedicated persistent resources starting at ₹10/mo on Paid Discord Bot Hosting.