If you've ever used a game server hosting provider, chances are you've interacted with the Pterodactyl Panel. It's the industry-standard, open-source game server management panel used by hundreds of hosting companies worldwide — including Azion Cloud. But most users only scratch the surface of what Pterodactyl can do.
This comprehensive guide covers everything you need to know about Pterodactyl — from basic server management to advanced features that most users never discover. Whether you're managing a Minecraft server, a FiveM RP server, or a Discord bot, this guide will help you get the most out of your hosting panel.
What Is Pterodactyl Panel?
Pterodactyl is an open-source, web-based game server management panel built with PHP (Laravel) and React. It was designed from the ground up to be secure, performant, and user-friendly. The name comes from the flying dinosaur — fitting for a panel that gives your servers wings.
Why Hosting Providers Use Pterodactyl
Pterodactyl has become the de facto standard in the game hosting industry for several important reasons:
- Docker-based isolation: Every server runs inside its own Docker container, completely isolated from other servers. This means one server crashing can't affect others on the same machine.
- Resource limits: CPU, RAM, disk, and network usage are strictly enforced per-server through Docker's cgroup controls. You always get the resources you paid for.
- Multi-game support: Through "eggs" (server templates), Pterodactyl supports hundreds of games — Minecraft (all variants), FiveM, Palworld, CS2, Rust, ARK, Terraria, Valheim, and many more.
- API-driven architecture: Everything in Pterodactyl can be automated through its REST API, enabling hosting providers to build billing integrations, auto-provisioning, and monitoring systems.
- Security-first design: Two-factor authentication, CSRF protection, API keys with granular permissions, and encrypted connections are all built in.
Navigating the Dashboard
When you first log into Pterodactyl, you'll see your server list. Each server shows its name, status (online/offline/starting), current resource usage, and the server's IP address and port. Let's explore each section of the panel.
Console
The Console tab is your server's command center. Here you can:
- View real-time output: See everything your server prints to the console — player joins/leaves, errors, warnings, and plugin messages.
- Send commands: Type commands directly into the console input. For Minecraft, this means commands like
/op PlayerName,/whitelist add Player, or/stop. For FiveM, you can run server-side commands. - Monitor resources: The top of the console shows live CPU usage, RAM usage, network I/O, and disk usage. This is invaluable for diagnosing performance issues.
- Start/Stop/Restart: The power buttons let you control your server. "Kill" forcefully terminates the process — only use this if the server is stuck and won't respond to a normal stop.
Pro tip: If you're seeing errors in the console but they scroll by too fast, use the File Manager to check the latest log files. Most games store logs in a logs/ directory.
File Manager
Pterodactyl's built-in file manager is surprisingly powerful. You can:
- Browse files: Navigate your server's directory structure just like a desktop file explorer.
- Edit files in-browser: Click any text file to open it in the built-in code editor with syntax highlighting. Perfect for editing
server.properties, plugin configs, or script files without needing SFTP. - Upload files: Drag and drop files from your computer, or click the upload button. You can upload individual files or ZIP archives.
- Create archives: Select multiple files/folders and compress them into a ZIP. Great for creating backups or downloading large directories.
- Extract archives: Upload a ZIP file and extract it directly on the server. This is the fastest way to install modpacks or large resource packs.
- Rename, move, copy, delete: All standard file operations are available through the right-click context menu.
Databases
Many game servers and plugins need a database. Pterodactyl can create and manage MySQL databases for your server. This is commonly used by:
- Minecraft plugins: LuckPerms (permissions), CoreProtect (block logging), economy plugins, and player data storage.
- FiveM frameworks: Both QBCore and ESX store player data, vehicles, properties, and inventory in MySQL. See our QBCore vs ESX comparison for details.
- Discord bots: Bots that need persistent storage for guilds, users, and configuration.
To create a database, go to the Databases tab and click "New Database." You'll get a database name, host, port, username, and password. Use these credentials in your plugin/framework configuration files.
Schedules
Schedules let you automate recurring tasks. This is one of the most underused features in Pterodactyl. Here's what you can automate:
Automatic Restarts
Game servers benefit from periodic restarts. Memory leaks, entity buildup, and cache growth can all cause performance degradation over time. Set up a schedule to restart your server every 6-12 hours:
- Go to Schedules → Create Schedule
- Set the cron expression:
0 */6 * * *(every 6 hours) - Add action: Send command →
say Server restarting in 60 seconds... - Add action (60s delay): Send power action →
Restart
Automatic Backups
Schedule daily backups so you never lose progress:
- Create a schedule with cron:
0 4 * * *(daily at 4 AM) - Add action: Create backup
Scheduled Announcements
For Minecraft servers, you can schedule periodic announcements:
say Join our Discord: discord.gg/yourlinksay Vote for us at minecraft-server-list.com
Backups
Pterodactyl's backup system creates compressed snapshots of your entire server or specific directories. Key features:
- One-click backup: Create a complete backup of your server with a single click.
- Download backups: Download any backup to your local computer as a compressed archive.
- Restore backups: Restore a backup to roll your server back to a previous state. Useful after griefing, corruption, or failed updates.
- Backup limits: Most hosting plans have a backup limit (typically 3-5). Older backups can be deleted to make room for new ones.
- Exclude files: You can configure which files/directories to exclude from backups using the
.pteroignorefile. Exclude large, regeneratable files likecache/directories to save space.
Sub-Users
If you have staff or co-admins, sub-users let you grant them access to your server with granular permissions. You can control exactly what each person can do:
- Console access: View the console and send commands.
- File management: Read, write, create, or delete files.
- Backup management: Create, download, delete, or restore backups.
- Database access: View database credentials or create new databases.
- Schedule management: Create or modify scheduled tasks.
- Power controls: Start, stop, restart, or kill the server.
Each permission can be individually toggled. For example, you might give a moderator console access to ban players, but not file access to prevent them from modifying configs.
Network (Allocations)
The Network tab shows your server's IP address and port assignments. Some hosting providers offer additional ports (allocations) for features like:
- Dynmap: Minecraft's web-based live map needs a separate port.
- RCON: Remote console access on a dedicated port.
- Query: Server list query protocol port.
- Bedrock: If running GeyserMC for cross-platform play, you need a separate UDP port.
Startup
The Startup tab lets you modify your server's startup parameters. This includes:
- Server JAR: Choose which server file to run (e.g.,
paper.jar,server.jar,forge.jar). - Java version: Select the Java runtime (Java 17 or 21 for modern Minecraft versions).
- JVM flags: Customize memory allocation and garbage collection. We strongly recommend Aikar's flags for Minecraft servers.
- Game-specific variables: Depending on the egg, you may see variables like Minecraft version, server type, or FiveM license key.
SFTP Access
For bulk file operations or when the web file manager isn't enough, Pterodactyl provides SFTP access. Use clients like FileZilla, WinSCP, or Cyberduck to connect.
Your SFTP credentials are shown in the panel under Settings. The connection uses your panel username (with a server identifier suffix) and your panel password. SFTP runs on a separate port from regular SSH — typically port 2022.
SFTP is especially useful for:
- Uploading large modpacks (10+ GB)
- Downloading entire server directories for local backup
- Batch file operations that would be tedious in the web interface
- Syncing files between your local development environment and the server
Common Tasks by Game
Minecraft Server Management
- Change server version: Go to Startup, change the version variable, reinstall if needed.
- Install plugins: Upload
.jarfiles to theplugins/folder via File Manager. - Edit server.properties: Click the file in File Manager to edit in-browser. Key settings:
max-players,server-port,online-mode,motd. - Check TPS: Type
/tpsin the console (requires Paper/Spigot). See our lag reduction guide if TPS is low. - Whitelist management:
whitelist add PlayerNameandwhitelist onin the console.
FiveM Server Management
- Add resources: Upload resource folders to the
resources/directory. - Edit server.cfg: Add
ensure resourcenamefor each resource you want to load. - Database setup: Create a database in the Databases tab, then configure the connection string in your framework's config.
- Update artifacts: Change the artifact version in Startup variables to update your FiveM server build.
Discord Bot Management
- Set bot token: Use the Startup variables to set your
BOT_TOKENenvironment variable. - Upload bot code: Upload your bot files via File Manager or SFTP.
- Install dependencies: The console will automatically run
npm installorpip install -r requirements.txton startup (depending on the egg). - View logs: Check the console for runtime errors and bot status messages.
Troubleshooting Common Issues
Server Won't Start
- Check the console for error messages — they usually tell you exactly what's wrong.
- Verify you have enough RAM allocated. Modded Minecraft and Palworld need more RAM than vanilla. Check our RAM guide.
- Make sure the correct Java version is selected in Startup (Minecraft 1.17+ needs Java 17+).
- Check if a plugin/mod is causing the crash by removing recently added ones.
High RAM Usage
- Use Aikar's JVM flags for better garbage collection.
- Check for memory leaks in plugins — profile with Spark.
- Reduce view distance and simulation distance in
server.properties. - Schedule automatic restarts every 6-12 hours to clear accumulated memory.
Can't Connect to Server
- Verify the server is online in the panel.
- Check the IP and port shown in the Network tab.
- Ensure online-mode is set correctly (true for premium Minecraft, false for cracked).
- Check if DDoS protection is blocking your connection. See our DDoS protection guide.
Advanced Tips
Using .pteroignore
Create a .pteroignore file in your server root to exclude files from backups. Syntax is identical to .gitignore:
# Exclude cache and temporary files
cache/
*.log
logs/
dynmap/tiles/
# Exclude large regeneratable files
plugins/dynmap/web/tiles/
API Automation
Pterodactyl's API lets you automate server management. Create an API key in your account settings, then use it to:
- Query server status from external monitoring tools
- Send commands from Discord bots or web dashboards
- Automate backup downloads to external storage
- Build custom management interfaces
Two-Factor Authentication
Always enable 2FA on your Pterodactyl account. If someone gets your password, they can delete your entire server. Go to Account Settings → Two-Factor Authentication and scan the QR code with an authenticator app like Google Authenticator or Authy.
Getting Started with Pterodactyl on Azion Cloud
All Azion Cloud hosting plans include full access to the Pterodactyl panel. When you purchase a server, you'll receive an email with your panel URL, username, and a link to set your password.
Our panel is available at panel.azioncloud.com and includes all the features described in this guide. Need help with anything? Join our Discord for 24/7 support.