How to Host a Discord Bot on Vertra Cloud

Hosting a Discord bot on Vertra Cloud

A Discord bot runs on Vertra Cloud as a bot-type application: a background process with no exposed HTTP port, restarted automatically when it crashes and streamed live to the dashboard log. Vertra Cloud is a Brazilian application hosting platform (PaaS), and Discord, WhatsApp and Telegram bots are first-class workloads on it — the same containers, snapshots and metrics as any other application. This guide covers both discord.js (JavaScript) and discord.py (Python).

Discord.js (JavaScript)

Structure

my-bot-js/
├── src/
│   └── index.js
├── package.json
└── vertracloud.config

package.json

{
  "name": "my-bot-discord",
  "main": "src/index.js",
  "scripts": {
    "start": "node src/index.js"
  },
  "dependencies": {
    "discord.js": "^14.14.0"
  }
}

vertracloud.config

MAIN=src/index.js
START=npm start
VERSION=recommended

Example

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.once('ready', () => {
  console.log(`Bot online as ${client.user.tag}`);
});

client.on('messageCreate', (message) => {
  if (message.author.bot) return;
  if (message.content === '!ping') {
    message.reply('Pong! ');
  }
});

client.login(process.env.DISCORD_TOKEN);

Discord.py (Python)

Structure

my-bot-py/
├── main.py
├── requirements.txt
└── vertracloud.config

requirements.txt

discord.py==2.3.2

vertracloud.config

MAIN=main.py
VERSION=recommended

Example

import discord
import os

intents = discord.Intents.default()
intents.message_content = True

client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f'Bot online as {client.user}')

@client.event
async def on_message(message):
    if message.author == client.user:
        return
    if message.content == '!ping':
        await message.channel.send('Pong! ')

client.run(os.environ['DISCORD_TOKEN'])

Deploy

Dashboard
CLI
VS Code

Compress the project into a .zip (folders like node_modules, venv and target are removed automatically) or push it to GitHub.
In the dashboard, click New Project and upload the .zip or paste the repository URL.
In Build, check the runtime (JavaScript or Python), the main file (index.js or main.py) and the memory. Start and build commands are under Advanced settings.
Add your environment variables in Environment.
In Network, leave web publishing off: a bot doesn’t receive incoming traffic and runs in the background on any plan.
Review and deploy. Follow the output in the Logs tab.

vertra upload
vertra logs -f

See CLI for installation and login.

The full walkthrough is in First deploy.

Available Versions

Node.js

Version	Status	Description
24.22.1	Latest	Node.js 24.22.1 (latest version)
22.23.4	Recommended	Node.js 22.23.4 LTS (recommended for production)

Python

Version	Status	Description
3.13.17	Recommended	Python 3.13 (recommended for production)
3.14.10	Latest	Python 3.14 line
3.12.15	Stable	Python 3.12 line
3.11.17	Legacy	Python 3.11 line

Notes

Bot Type: Always select Bot when creating the application (not Website)
Environment variables: Configure DISCORD_TOKEN in the application’s variables
Auto-restart: On by default, keeps the bot online in case of disconnection
Memory: 256MB is enough for simple bots, 512MB+ for complex ones
Logs: Use console.log() (JS) or logging (Python) to monitor in real-time
Gateway: Both libraries keep a persistent WebSocket connection to the Discord gateway, so the bot needs no incoming traffic and no web publishing

Overview

Bots

Node.js

Python

Other Languages

Guides

How to Host a Discord Bot on Vertra Cloud

Hosting a Discord bot on Vertra Cloud

Discord.js (JavaScript)

Structure

package.json

vertracloud.config

Example

Discord.py (Python)

Structure

requirements.txt

vertracloud.config

Example

Deploy

Available Versions

Node.js

Python

Notes

​Hosting a Discord bot on Vertra Cloud

​Discord.js (JavaScript)

​Structure

​package.json

​vertracloud.config

​Example

​Discord.py (Python)

​Structure

​requirements.txt

​vertracloud.config

​Example

​Deploy

​Available Versions

​Node.js

​Python

​Notes

Hosting a Discord bot on Vertra Cloud

Discord.js (JavaScript)

Structure

package.json

vertracloud.config

Example

Discord.py (Python)

Structure

requirements.txt

vertracloud.config

Example

Deploy

Available Versions

Node.js

Python

Notes