How to Deploy a discord.py Bot on Pterodactyl Panel

To deploy a discord.py (Python) bot on VisiHost's Pterodactyl panel: (1) Upload your .py source scripts and requirements.txt file, (2) Set your Startup file to main.py or bot.py, (3) Define your DISCORD_TOKEN variable in the Startup tab, and (4) Start your server console to run pip install -r requirements.txt automatically.

---

Prerequisites

1. An active VisiHost Free Bot Tier or Paid Discord Bot Hosting container.
2. Python 3.10, 3.11, or 3.12 compatibility for your bot code.
3. Your secret bot token from the Discord Developer Portal.

---

Step-by-Step Deployment Instructions

Step 1: Create a requirements.txt File

Include all Python package dependencies needed for your bot to run smoothly.

Example requirements.txt:

discord.py>=2.3.2
python-dotenv>=1.0.1
aiohttp>=3.9.0
requests>=2.31.0

Security Tip: Never commit or upload your actual .env file containing secrets to public repositories. Manage token credentials through panel environment variables.

---

Step 2: Upload Project Files

1. Log into your dashboard at free.visihost.in or paid.visihost.in.
2. Open your Python Bot Container server.
3. Click the Files tab and upload your .py script files (e.g., bot.py, cogs/), along with requirements.txt.

---

Step 3: Configure Startup Command & Environment Variables

1. Go to the Startup tab.
2. Set Python Main File to your main script name (e.g., bot.py or main.py).
3. Under Environment Variables, configure your bot token:
   • Key: DISCORD_TOKEN
   • Value: MTE...your_token_here...

Example bot.py token reading:

import os
import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_ready():
    print(f"Logged in as {bot.user} (ID: {bot.user.id})")

token = os.getenv("DISCORD_TOKEN")
if not token:
    raise ValueError("DISCORD_TOKEN environment variable is missing!")

bot.run(token)

---

Step 4: Install Dependencies & Run

1. Open the Console tab.
2. VisiHost's Python container automatically installs packages listed in requirements.txt upon initial boot into an isolated virtual environment (venv).
3. Click Start and observe the live log stdout.

---

Common Python Discord Bot Issues

1. ModuleNotFoundError: No module named 'discord'

• Cause: Package not listed in requirements.txt or syntax error during pip install.
• Fix: Open the Files tab, verify requirements.txt includes discord.py, and restart the container from the Console tab.

2. discord.errors.LoginFailure: Improper token has been passed

• Cause: Missing or incorrectly copied token in Environment Variables.
• Fix: Verify your token in the Startup tab and ensure there are no trailing spaces or quotation marks around the string.

---

Related Documentation

• Review memory limits in our Discord Bot RAM & CPU Requirements Guide.
• Learn troubleshooting steps in Discord Bot Crash Troubleshooting.
• Upgrade to persistent AMD Ryzen/EPYC performance on Paid Discord Hosting.