How do I upload and structure my bot files?

Once your plan is ready, getting your bot's code onto the server takes just a couple of minutes. This article walks you through uploading your files and structuring them so the panel finds everything on the first try.

Uploading your files

You'll do all of this from the Files tab in the panel.

1. Open your server in the panel and go to the Files tab.
2. Upload your files — drag and drop them straight into the file manager, or use SFTP for larger projects with many files.
3. Place your main file and your dependency file (package.json for Node.js or requirements.txt for Python) in the root folder, with any assets (images, config files) alongside them.

How to structure your project

A clean layout in the root folder keeps your startup command simple:

• Keep your entry file (for example index.js or bot.py) in the root.
• Keep your dependency file in the root so packages install automatically.
• Put supporting assets and config beside them, using relative paths from the root.

Tip: Keep the entry file in the root so the startup command finds it without extra path juggling. If your file lives in a subfolder, you'll need to include that folder in the startup path.

Frequently asked questions

Should I upload a zip or the individual files? Either works. You can upload an archive and unpack it in the Files manager, or drag individual files in. For big projects, SFTP is smoothest.

Do I need to upload my node_modules / installed packages? No — dependencies install automatically from your package.json or requirements.txt, so you can leave those out.