# Pterodactyl — Open-Source Game Server Management Panel

> Manage game servers through a polished web UI backed by isolated Docker containers, with fine-grained user permissions and a powerful API.

## Install

Save in your project root:

# Pterodactyl — Open-Source Game Server Management Panel

## Quick Use
```bash
# Install Wings (daemon) on each game node
curl -sSL https://get.docker.com | bash
mkdir -p /etc/pterodactyl
# Download wings binary
curl -Lo /usr/local/bin/wings 
  https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64
chmod +x /usr/local/bin/wings
wings configure --panel-url https://panel.example.com --token <TOKEN>
systemctl start wings
```

## Introduction
Pterodactyl is a free game server management panel built with PHP and React. It runs every game server inside its own Docker container, providing strong isolation and consistent environments for titles like Minecraft, Rust, ARK, and Counter-Strike.

## What Pterodactyl Does
- Deploys and manages game servers through a responsive web interface
- Isolates each server in a Docker container with resource limits on CPU, RAM, and disk
- Provides a file manager, console, and schedule system per server
- Supports fine-grained user roles so multiple admins or players can share a node
- Offers a comprehensive REST API for automation and billing integrations

## Architecture Overview
Pterodactyl splits into two components: the Panel (a Laravel PHP app serving the web UI and API) and Wings (a Go daemon running on each node). The Panel stores configuration in MySQL and communicates with Wings over authenticated HTTPS. Wings interfaces with Docker to create, start, stop, and monitor containers, streaming console output back to the browser via WebSockets.

## Self-Hosting & Configuration
- Panel requires PHP 8.1+, MySQL/MariaDB, Redis, and a web server (nginx or Apache)
- Wings requires Docker and runs as a systemd service on each game node
- Configure panel-to-wings communication with auto-generated API tokens
- Allocate IP addresses and ports per node through the admin area
- Use community-maintained Eggs (server templates) for 200+ game titles

## Key Features
- Docker-based isolation with per-server CPU, memory, and I/O limits
- Real-time server console with command input from the browser
- Built-in file manager with editor, upload, and download support
- Scheduled tasks for backups, restarts, and custom commands
- Two-factor authentication and granular permission system

## Comparison with Similar Tools
- **Pelican** — community fork continuing Pterodactyl development with new features
- **AMP (CubeCoders)** — commercial panel with broader OS support but closed source
- **Crafty Controller** — Python-based, Minecraft-focused, lighter weight
- **LinuxGSM** — CLI-only toolkit, no web panel included
- **Pufferpanel** — simpler alternative with fewer features and a smaller community

## FAQ
**Q: Which games does Pterodactyl support?**
A: Any game that can run in a Linux Docker container. Community Eggs cover Minecraft, Rust, Valheim, ARK, CS2, Terraria, and 200+ other titles.

**Q: Can I run the Panel and Wings on the same machine?**
A: Yes, though for production it is recommended to separate them so the panel's web traffic does not compete with game server resources.

**Q: How are backups handled?**
A: Pterodactyl supports local and S3-compatible remote backup targets, configurable per node. Players can trigger backups from the panel or schedule them.

**Q: Is there a billing integration?**
A: Pterodactyl itself does not include billing, but WHMCS modules and third-party solutions like Jexactyl and Billing integrate through the API.

## Sources
- https://github.com/pterodactyl/panel
- https://pterodactyl.io/project/introduction.html

---
Source: https://tokrepo.com/en/workflows/5bc7ab16-3f97-11f1-9bc6-00163e2b0d79
Author: AI Open Source