How to Host Your Discord Bot

Get your Discord bot up and running on BaggyBlue in just a few minutes. Follow these simple steps to deploy your bot.

1Create Your Account

Navigate to https://baggyblue.fun and click the Get Started button.

2Discord Authorization

Click Continue with Discord and authorize BaggyBlue to access your Discord account.

3Select Server Type

Choose your server type from the dropdown menu:

  • Node.js - For JavaScript/TypeScript bots
  • Python - For Python-based bots

4Create Your Server

Click Create. You'll be automatically redirected to the panel.

5Get Your Credentials

Go back to the dashboard, open the Account tab, and copy your login credentials.

6Login to Panel

Return to the panel and log in using the credentials you copied.

7Upload Your Files

Click on your server, navigate to the Files tab, and upload your bot files. Don't forget to update your Discord bot token!

8Start Your Bot

Head to the Console tab and click the Start button to launch your bot.

Congratulations! Your Discord bot is now running on BaggyBlue.

How to Clone a Git Repository

Automatically deploy your bot directly from GitHub, GitLab, or other Git hosting services.

Basic Setup

Repository Configuration

Go to the Startup section in your server settings and configure:

  • Repository Address: Your repo URL (e.g., https://github.com/yourusername/reponame)
  • Install Branch: Usually master or main - this is the production branch

Private Repository Setup

Note: If your repository is private, you'll need to provide authentication credentials.

Required Credentials

  • Git Username: Your Git hosting username
  • Personal Access Token: A token generated from your Git host

Creating Personal Access Tokens

For GitHub:

Visit GitHub Token Documentation

For GitLab:

Visit GitLab Token Documentation

For Other Services:

Check your Git hosting provider's documentation for personal access token generation.

Triggering Auto-Clone on Restart

Warning: Make sure to backup any important files before proceeding. This will remove existing files.
  1. Ensure your server has no files (backup anything important first)
  2. Go to Settings
  3. Click Reinstall Server
  4. This will pull the latest code from your repository every time your bot restarts

Startup Configuration

Customize how your bot starts and which file it executes.

Changing the Main File

Go to the Startup section in your server settings.

Change the default main file to your bot's entry point:

  • For root files: filename.js or filename.py
  • For nested files: folder/filename.js or folder/filename.py
Examples:
index.js bot.py src/index.js app/main.py

Managing Additional Packages

Install extra dependencies your bot needs to run properly.

Adding Packages

Navigate to the Startup section to add packages:

For Node.js Bots

Add packages in the Additional Node Packages field.

express discord.js dotenv axios

For Python Bots

Add packages in the Additional Python Packages field.

discord.py requests python-dotenv aiohttp
Formatting: Separate multiple packages with spaces, not commas.

Connecting via SFTP

Access and manage your server files using SFTP (SSH File Transfer Protocol).

What is SFTP?

SFTP allows you to securely transfer files between your computer and your server. It's more convenient than using the web panel for managing multiple files.

SFTP Client Options

Recommended Clients

  • FileZilla - Free, cross-platform (Windows, Mac, Linux)
  • WinSCP - Windows only, user-friendly
  • Cyberduck - Mac and Windows

Getting Your SFTP Credentials

  1. Log into your BaggyBlue panel
  2. Click on your server
  3. Go to the Settings tab
  4. Look for the SFTP Details section

You'll find:

  • Server Address: The hostname and port
  • Username: Your SFTP username
  • Password: Same as your panel password

Connecting with FileZilla

  1. Open FileZilla
  2. Go to File → Site Manager
  3. Click New Site
  4. Enter your connection details:
    • Protocol: SFTP - SSH File Transfer Protocol
    • Host: Your server address (without port)
    • Port: The SFTP port number
    • Logon Type: Normal
    • User: Your SFTP username
    • Password: Your panel password
  5. Click Connect
First Connection: You may see a security warning about an unknown host key. This is normal - click "OK" or "Accept" to continue.

Using SFTP

Once connected, you can:

  • Drag and drop files between your computer and server
  • Edit files directly (right-click → Edit)
  • Create new folders and files
  • Delete or rename files
  • Download entire folders
Pro Tip: Save your connection in the Site Manager for quick access in the future!

Error Explanations & Solutions

Common errors you might encounter and how to resolve them.

Panel Connection Error
"We're having some trouble connecting to your server, please wait..."

Meaning: The node is currently down or unreachable.

Action: Wait for a few minutes. The node should come back online automatically once it's restored. No action required on your end.

Dashboard Error
"baggyblue.fun dice Error creating server: Failed to create server: [object Object]"

Meaning: The node is either full (no available slots/resources) or temporarily down.

Action: Try again later. The hosting provider may be upgrading resources or performing maintenance.

Cloudflare Error (502/503/504)

Meaning: The panel itself is down, not just your server node.

Action: Wait until the panel service is back online. This is a host-side issue and will be resolved automatically. Common during maintenance or updates.

Missing Files After Restart

Meaning: The VPS node was changed or reset, causing file loss.

Action: This is why backups are important! Always keep a local copy of your bot files or use Git integration. You'll need to re-upload your files.

Prevention: Use Git repository integration to automatically restore your files after node changes.
Connection Timeout Error

Meaning: Your network connection is too slow or unstable to complete the request.

Action: Try again once your internet connection improves. Consider using a more stable network if the problem persists.

Running Installer / Installing Egg

Meaning: The server is currently installing or setting up the environment.

Action: Wait for the installation to complete. This usually takes 2-5 minutes.

Extended Installation: If you're still seeing this after 10 minutes, it means the node is rebooting. Try again later once it has fully booted up.

General Troubleshooting Tips

  • Check the BaggyBlue Discord or status page for known issues
  • Clear your browser cache if the panel isn't loading correctly
  • Try a different browser if problems persist
  • Always keep local backups of your bot files
  • Use Git integration for automatic file restoration