Welcome to Orbital Host — Get 60% OFF your first order with code WELCOME

Helpcenter / Bot Hosting / How to Configure Startup Settings

How to Configure Startup Settings

Bot Hosting

⚡ Quick Setup (Most Users)

  1. Select Node.js
  2. Set Startup File to: index.js
  3. Upload your bot files OR use GitHub
  4. Click Start

🧠 What Are Startup Settings?

Startup settings control:

  • What language your bot runs on (Node.js, Python, Java)
  • What file gets executed when the server starts
  • How your code is installed and updated
  • What dependencies your bot needs

🪜 Step 1: Choose Your Runtime

🤖 Node.js (Most Discord Bots)

  • Node.js 20
  • Node.js 21
  • Node.js 22
  • Node.js 23
  • Node.js 24

Use Node.js for Discord bots, APIs, and web apps.


🐍 Python

  • Python 3.7
  • Python 3.8
  • Python 3.9
  • Python 3.10
  • Python 3.11
  • Python 3.12
  • Python 3.13

Use Python for discord.py bots and scripts.


☕ Java

  • Java 8
  • Java 11
  • Java 16
  • Java 17
  • Java 19
  • Java 21

Use Java for Java-based applications.


⚠️ IMPORTANT:
If you choose the wrong runtime, your bot will NOT start.


▶️ Step 2: Set Your Startup File

This tells the server what file to run.

Examples:

Node.js:
index.js

Python:
main.py

Java:
server.jar

⚠️ IMPORTANT:

  • The file must exist in your server
  • The name must match exactly (case-sensitive)

📂 Step 3: Add Your Bot Files

Option A: Upload Files

  1. Enable User Uploaded Files
  2. Go to File Manager
  3. Upload your bot files
  4. Make sure your startup file is in the main folder

Option B: Use GitHub

Git Repo Address:
https://github.com/yourusername/yourbot

  • Leave branch blank or use main
  • Use a token only if the repo is private

Your bot will download automatically when the server starts.


🔄 Step 4: Auto Update (Recommended)

Enable Auto Update

This will:

  • Pull updates from GitHub automatically
  • Keep your bot up to date

📦 Step 5: Install Dependencies

Node.js Packages

discord.js dotenv axios

If you have a package.json file, this is usually not required.


Python Packages

discord.py flask


Requirements File (Python)

requirements.txt


⚙️ Step 6: Other Settings

You can usually leave these blank:

  • Additional Arguments
  • Uninstall Packages

🚀 Step 7: Start Your Bot

  1. Click Start
  2. Open the Console
  3. Watch for logs or errors

❌ Common Problems

Server not starting?

  • Wrong runtime selected
  • Startup file is incorrect
  • Files are missing

Missing module error?
Example:
Cannot find module 'discord.js'

Fix:

  • Add it under Node.js Packages
  • OR upload your package.json

Python error?
Example:
ModuleNotFoundError

Fix:

  • Add packages under Python Packages
  • OR use requirements.txt

🔐 Security Tips

  • Never share your bot token
  • Use .env files for secrets
  • Regenerate your token if it gets leaked

🎉 You're Done!

Your bot should now be running 🚀

Do you think this article is helpful?

0 people thought this article was helpful (0 votes)