How to Deploy WhatsApp Bot on Koyeb (Complete A to Z Guide)

Koyeb is becoming a popular cloud platform for hosting Node.js applications. It is fast, modern, and very suitable for WhatsApp bots built with Baileys. If you want your bot to stay online without managing a VPS, Koyeb is a great choice.

This guide explains the complete process from preparing your bot to pairing WhatsApp after deployment.

What You Need Before Starting

• Your WhatsApp bot project ready
• GitHub account
• Koyeb account
• package.json with start script

Step 1: Prepare package.json

"scripts": {
  "start": "node index.js"
}

Step 2: Upload Bot to GitHub

Create a repository and upload your bot files. Koyeb pulls code directly from GitHub.

Step 3: Create Service on Koyeb

Login to Koyeb dashboard → Create App → Select GitHub repository.

Step 4: Configure Build Settings

• Runtime: Node.js
• Build Command: npm install
• Start Command: npm start

Step 5: Add Environment Variables

If your bot uses variables like PREFIX or OWNER_NUMBER, add them in Environment Variables section.

Step 6: Deploy the Service

Click deploy. Koyeb will install dependencies and start the bot.

Step 7: Open Logs for QR Code

After deployment, open logs. You will see the pairing QR or code.

Step 8: Pair WhatsApp

Go to WhatsApp → Linked Devices → Scan QR.

Common Problems and Fixes

• App crash: Check start command
• Module errors: Ensure dependencies are saved
• No QR in logs: Check console output in index.js

Why Koyeb is Good for Bots

• No server management
• Fast deployment
• Stable uptime
• Easy GitHub integration

Conclusion

Koyeb provides a simple and reliable method to host your WhatsApp bot. With proper setup and GitHub integration, your bot can run online smoothly without needing VPS management.