Manage Your Server

The KataBump server console allows you to control the state of your bot, view logs in real time, and manage the process.

Access the Console

1. Log in to control.katabump.com
2. Select your server
3. The "Console" tab opens by default

Server Controls

Start the Server

1. Click the "Start" button
2. Wait for the status to change to "Online"
3. Logs appear in the console in real time

First Start

On first start, KataBump automatically installs dependencies (npm install for Node.js, pip install for Python).

Stop the Server

• Stop - Graceful shutdown (sends SIGTERM to the process)
• Kill - Forced shutdown (use if Stop doesn't work)

Note

Stopping the server will disconnect your Discord bot. Users will no longer be able to interact with it.

Restart the Server

Restart is useful after:

• Modifying environment variables
• Updating code
• Installing new dependencies

Click "Restart" for a full restart.

Understanding Logs

The console displays your application's output messages in real time.

Log Types

Color	Type	Description
White	Standard	console.log(), print()
Yellow	Warning	console.warn()
Red	Error	console.error(), syntax errors

Important Logs to Watch

# Node.js with discord.js
Ready! Logged in as MyBot#1234
# → Bot connected successfully

# Python with discord.py
Logged in as MyBot#1234 (ID: 123456789)
# → Bot connected successfully

# Authentication error
[DISCORD] TOKEN_INVALID
# → Check your DISCORD_TOKEN in environment variables

Server Status

The displayed status can be:

Status	Description
Online	Bot is running normally
Stopped	Server is stopped
Starting	Initialization in progress
Error	An error prevents startup
Suspended	Check the reason for the suspension at dashboard.katabump.com

Server Settings

Modify Settings

In the "Settings" tab, you can modify:

• Server name - For easy identification

In the "Startup" tab, you can modify:

• Runtime version - Change Node.js/Python version
• Entry point file - The JS/PY file to run
• Additional packages - Extra packages to install

Runtime Version

You can change the Node.js or Python version at any time:

1. Go to the "Startup" tab on control.katabump.com
2. Select the new version
3. Click "Save"
4. Restart the server

Version Change

Changing versions may require adapting your code. Always test locally first.

Common Errors

"Module not found" (Node.js)

Error: Cannot find module 'discord.js'

Solution:

• Verify that package.json is present
• Restart the server to reinstall dependencies

"No module named" (Python)

ModuleNotFoundError: No module named 'discord'

Solution:

• Verify that requirements.txt is present
• Restart the server

"Invalid token"

[WS => Manager] The token you provided is invalid

Solution:

• Check your DISCORD_TOKEN in environment variables
• Make sure there are no extra characters (spaces, line breaks)

Server Keeps Restarting

If your server constantly restarts:

1. Check the logs to identify the error
2. Verify your code (syntax error, infinite loop)
3. Make sure the bot handles errors correctly

// Example: recommended error handling
process.on('unhandledRejection', (error) => {
    console.error('Unhandled error:', error);
});

process.on('uncaughtException', (error) => {
    console.error('Uncaught exception:', error);
    process.exit(1); // Allow the server to restart cleanly
});

Resource Statistics

Free Plan Quotas

Resource	Limit
RAM	308 MB
Disk	716 MB
CPU	25% (shared)

Optimization

To optimize resource usage:

// Node.js - Limit memory if needed
// In package.json
{
  "scripts": {
    "start": "node --max-old-space-size=256 index.js"
  }
}

# Python - Free memory regularly
import gc
gc.collect()  # Force the garbage collector

Next Step

Server running? Learn how to renew it to keep your bot online!