FAQ - Frequently Asked Questions

Quickly find answers to the most common questions about KataBump.

General

What is KataBump?

KataBump is a hosting platform for Discord bots developed in Node.js or Python. We provide the infrastructure needed to host your bot 24/7.

Is it really free?

Yes! The basic hosting plan is entirely free, with no credit card required. You get access to a free server with 308 MB RAM and 716 MB of storage.

Why is it free?

We offer paid plans (Starter, Pro, Advanced, Expert) to fund the infrastructure. The free plan allows everyone to get started and test their projects.

Server Creation

How many servers can I create?

The number of servers depends on your plan. See Plans for details.

What Node.js/Python version should I choose?

Node.js

• 18.x LTS - Recommended (stable, long-term support)
• 20.x LTS - Latest stable version
• Avoid non-LTS "Current" versions

Python

• 3.10 - Recommended stable version
• 3.11 - Latest version with better performance
• 3.12 - Latest version (check compatibility)

Can I change the server type after creation?

Yes, you can switch between Node.js and Python at any time from the "Startup" tab on control.katabump.com.

Files and Deployment

What files are required?

Node.js:

• package.json (required)
• Entry point file (usually index.js)

Python:

• requirements.txt (required)
• Main file (usually main.py)

How does dependency installation work?

KataBump automatically detects your project type and installs dependencies:

• Node.js: Runs npm install automatically on first start
• Python: Runs pip install -r requirements.txt automatically

Can I use Git?

Yes! You can clone a Git repository directly from the console:

# In your server console
git clone https://github.com/user/my-bot.git .

What is the maximum upload size?

• Via Web: 100 MB per file (ZIP upload)
• Via SFTP: No theoretical limit
• Total storage: 716 MB per server (Free plan)

For large projects, create a ZIP file before uploading, then unzip it via the file manager.

Environment Variables

Where are variables stored?

Variables are securely stored on our servers, separate from your files. They are only accessible by your process.

Why isn't my token recognized?

Check:

1. That the variable is properly named (usually DISCORD_TOKEN)
2. That there are no spaces before/after the value
3. That you restarted the server after modification
4. That you're using process.env.DISCORD_TOKEN (Node.js) or os.getenv('DISCORD_TOKEN') (Python)

How do I set environment variables?

Create a .env file at the root of your project and upload it to your server. Use dotenv (Node.js) or python-dotenv (Python) to load the variables in your code. See Set Environment Variables for details.

When should I restart after modifying variables?

Always! Variables are loaded at process startup. A restart is required for changes to take effect.

Connection and Errors

"Invalid token" / "TOKEN_INVALID"

• Check your token in environment variables
• Make sure there are no spaces or line breaks
• Regenerate the token on the Discord Developer Portal if needed

"Module not found" (Node.js)

• Verify that package.json contains all dependencies
• Restart the server to reinstall dependencies
• Check spelling in your require() statements

"No module named" (Python)

• Verify that requirements.txt exists and contains the modules
• Restart the server
• Make sure you're using the correct casing (Discord ≠ discord)

Server keeps restarting

This usually indicates a fatal error:

1. Check the logs to identify the error
2. Verify your code (syntax error, infinite loop)
3. Make sure the bot handles errors correctly
4. Check that you don't have unnecessary process.exit() calls

SFTP and Connection

What are the SFTP credentials?

Retrieve them from your server panel at control.katabump.com, in the "Settings" section:

• Host: sftp://sftp.xx-node-xx.katabump.com:2022 (unique per server)
• Username: Your server ID
• Password: Same as your control panel password (found on dashboard.katabump.com)

Can't connect via SFTP

Check:

1. That you're using the correct server address (it's unique per server)
2. That you're using the SFTP protocol (not FTP)
3. That your credentials are correct (no extra spaces)
4. That your IP isn't blocked after too many failed attempts

DDoS Protection

If SFTP is not working, it may be because the node is under DDoS protection. Wait a few moments and try again, or use Web FTP in the meantime.

Where should I upload files via SFTP?

Always to /home/container, never to the root (/). This is your application's working directory.

Renewal

When do I need to renew my server?

Every 4 days for free servers. You will receive reminders by email and on Discord.

What happens if I don't renew?

• Expiration: Server suspended
• 1 day after expiration: Server and files permanently deleted

Can I renew early?

It depends on your plan:

• Free servers: You can only renew within the 2 days before expiration (due date included).
• Paid servers: You can renew at any time.

Can I recover a deleted server?

No, once deleted, data is irreversibly lost. Make regular backups!

Resources and Limits

What are the quotas?

Free plan:

• 308 MB RAM
• 716 MB storage
• 25% CPU

See Plans for paid plan resources (up to 8 GB RAM, 32 GB storage, 500% CPU).

What happens if I exceed RAM?

The process will be killed (OOM - Out of Memory) and restarted automatically. Check out the paid plans for more resources.

Can I use a database?

• SQLite: Yes, included in all plans
• MariaDB: Available in paid plans (Starter and above)
• MongoDB: Use MongoDB Atlas (free cloud tier available)
• External databases: You can connect to any database outside our infrastructure

Limitations

API Rate Limits

Each hosting account is limited to 250 requests per minute to the Discord API. This threshold can be increased if needed by contacting our team on Discord.

See Discord Rate Limits for details.

Prohibited Usage

Self-bots are not allowed on our infrastructure. Requests will be blocked and your account will be reported. All bots must comply with Discord's Terms of Service.

See Limitations & Rules for full details.

Support

How do I contact support?

• Discord - Fast response
• Email: support@katabump.com

Where do I report a bug?

Open a ticket on our Discord server in the #support channel.

Can I suggest a feature?

Yes! Post your suggestions on Discord in #suggestions. We review them regularly.

Security

Is my data safe?

Yes:

• Tokens are encrypted and isolated
• SFTP connections are secured
• Servers are isolated from each other

Can I share my account?

No, account sharing is prohibited and may result in suspension.

What if my token is compromised?

1. Immediately revoke the token on the Discord Developer Portal
2. Generate a new token
3. Update the environment variable on KataBump
4. Restart your server

Specific Problems

My bot doesn't respond to commands

Check:

1. That the bot is online (status "Online")
2. That intents are correctly configured
3. That the bot has the necessary permissions on the server
4. Error logs in the console

Slash commands don't appear

• Slash commands can take up to 1 hour to appear globally
• For a specific server, they should appear instantly
• Verify that you've synced commands in your code
• Regenerate the invite link with the applications.commands scope

My bot disconnects randomly

Possible causes:

• Unhandled error in code
• Temporary network issue
• Invalid or revoked token
• Discord rate limit

Add robust error handling and check the logs.

---

Didn't find your answer?

Join our Discord server and open a ticket. Our team is here to help!