Skip to content

Upload Your Bot Files via Web

The web interface lets you upload your bot files directly from your browser. This is the simplest method to quickly deploy your bot.

Prepare Your Files

Before uploading, you must create a ZIP file of your code.

Important

Remember to include your package.json (Node.js) or requirements.txt (Python) in the ZIP file so the system can install your modules automatically.

Required File Structure

For Node.js

my-bot.zip
├── package.json      ← Required
├── package-lock.json ← Recommended
├── index.js          ← Entry point (or as specified in Startup settings)
├── config/
│   └── settings.json
└── commands/
    └── ping.js

For Python

my-bot.zip
├── requirements.txt  ← Required
├── main.py           ← Entry point
├── config/
│   └── settings.json
└── cogs/
    └── moderation.py

Upload Your ZIP File

  1. Log in to control.katabump.com
  2. Select your server
  3. Go to the "Files" tab
  4. Drag and drop your ZIP file into the file manager area
  5. Wait for the upload to complete

File Size Limit

The upload is limited to 100 MB. If your file is larger, use SFTP instead.

Unzip Your File

Once uploaded, you need to unzip the file on the panel:

  1. Right-click on your ZIP file in the file manager
  2. Click "Unarchive" (or the decompress option)
  3. Wait for the extraction to complete
  4. You can delete the ZIP file after extraction

Available Actions

In the file manager, you can:

ActionDescription
Create folderOrganize your files into folders
Create fileCreate and edit files directly in the browser
EditModify your files online
DeleteDelete files and folders
DownloadDownload your files locally
ReloadRefresh the file tree

Edit a File Online

  1. Click on the file you want to modify
  2. The text editor opens
  3. Make your changes
  4. Click "Save" to save

Note

The online editor is convenient for small edits. For major changes, prefer SFTP or work locally before uploading.

Deploy Your Bot

Once your files are uploaded and unzipped:

  1. Make sure all required files are present
  2. Configure your environment variables
  3. Configure your startup file in the "Startup" tab
  4. Click "Start" in the console to launch your bot
  5. Check the logs to verify everything is working

Troubleshooting

Upload Too Slow

  • Make sure your ZIP file is under 100 MB
  • For larger projects, use SFTP

Some Files Don't Show Up

  • Refresh the page with F5
  • Clear your browser cache
  • Check that the files are not hidden

Error After Upload

  • Make sure you unzipped the file on the panel
  • Check your project structure
  • Ensure package.json (Node.js) or requirements.txt (Python) is present at the root
  • Check the error logs in the console

Prefer SFTP?

For frequent transfers or large projects, use SFTP with FileZilla or any other SFTP client. SFTP has no file size limit.

Official KataBump Documentation