🎮 Install Pterodactyl on your LibraHost VPS#

Install Pterodactyl Panel and Wings on your LibraHost VPS using an automatic installation script. Easily manage your game servers (Minecraft, Garry's Mod, CS2, etc.) from a modern web interface!

🎯 Objective#

• Prepare the VPS for installation
• Install Pterodactyl Panel (web administration interface)
• Install Wings (daemon that manages game servers)
• Configure the firewall
• Create your first administrator user

🧰 Prerequisites#

• A LibraHost VPS with minimum 2 GB RAM and 20 GB storage
• A supported operating system:
  • Ubuntu 22.04 or 24.04 (recommended)
  • Debian 10, 11, 12 or 13
  • Rocky Linux 8 or 9
  • AlmaLinux 8 or 9
• Root access to the VPS (via SSH)
• Your VPS IPv4 address

⚠️ Important: This guide uses the VPS IPv4 address without SSL certificate. For a production environment with domain name and HTTPS, please refer to the official Pterodactyl documentation.

---

1️⃣ VPS Preparation#

🔹 Connect via SSH#

ssh root@YOUR_VPS_IP

🔹 Update the system#

apt update && apt upgrade -y

🔹 Install basic dependencies#

apt install -y curl wget sudo

---

2️⃣ Run the installation script#

🔹 Execute the automatic script#

Run the following command as root:

bash <(curl -s https://pterodactyl-installer.se)

The script displays a menu with several options:

[0] Install the panel
[1] Install Wings
[2] Install both [0] and [1] on the same machine

🔹 Choose the installation option#

💡 Recommendation: To get started, choose option 2 to install both components on the same VPS.

---

3️⃣ Panel Configuration#

After choosing the option, the script asks you several questions:

🔹 Database configuration#

Database name (panel): panel
Database username (pterodactyl): pterodactyl
Database password: YourSecurePassword

💡 Tip: Use a strong password for the database. Write it down carefully!

🔹 Timezone configuration#

Select timezone: Europe/Paris

🔹 Email configuration#

Email address for the initial admin account: [email protected]

🔹 Administrator user configuration#

Username (admin): admin
First name: Your
Last name: Name
Password: YourAdminPassword

⚠️ Important: Write down these credentials, you will need them to log into the panel!

🔹 FQDN configuration (domain name)#

Since we are using only the IPv4:

FQDN (e.g panel.example.com): YOUR_VPS_IP

Simply enter your VPS IP address (e.g.: 51.178.xxx.xxx).

🔹 SSL configuration#

Do you want to configure Let's Encrypt automatically? (y/N): N

Answer N because we are not using a domain name.

🔹 Firewall configuration#

Do you want to automatically configure UFW? (y/N): y

Answer y to automatically configure the firewall.

---

4️⃣ Wings Configuration#

If you chose option 2, the script continues with Wings installation:

🔹 FQDN configuration for Wings#

FQDN (e.g node.example.com): YOUR_VPS_IP

Enter the same IP address as for the panel.

🔹 SSL configuration for Wings#

Do you want to configure Let's Encrypt automatically? (y/N): N

Answer N.

🔹 Firewall configuration for Wings#

Do you want to automatically configure UFW? (y/N): y

Answer y.

🔹 MySQL database configuration for hosts#

Do you want to configure MySQL to be used by hosts? (y/N): y

Answer y if you want your game servers to be able to use MySQL.

---

5️⃣ Finalize Wings Configuration#

Once the installation is complete, you need to connect Wings to the Panel:

🔹 Access the panel#

Open your browser and go to:

http://YOUR_VPS_IP

Log in with the administrator credentials created earlier.

🔹 Create a Location#

1. Go to Admin (gear icon in the top right)
2. Click on Locations in the left menu
3. Click on Create New
4. Fill in:
   • Short Code: local
   • Description: Local server
5. Click Create

🔹 Create the Node#

1. Click on Nodes in the left menu
2. Click on Create New
3. Fill in the information:

1. Click Create Node

🔹 Get the Wings configuration#

1. Click on the node you just created
2. Go to the Configuration tab
3. Click on Generate Token
4. Copy the displayed command

🔹 Apply the configuration on the VPS#

Back in your SSH terminal, paste and execute the copied command. It looks like:

cd /etc/pterodactyl && sudo wings configure --panel-url http://YOUR_VPS_IP --token YOUR_TOKEN --node 1

🔹 Start Wings#

sudo systemctl enable --now wings

Verify that Wings is running:

sudo systemctl status wings

---

6️⃣ Add allocations (ports)#

To create game servers, you need to allocate ports:

1. In the panel, go to Admin > Nodes
2. Click on your node
3. Go to the Allocation tab
4. Fill in:
   • IP Address: 0.0.0.0
   • Ports: 25565-25575 (for Minecraft for example)
5. Click Submit

💡 Tip: You can add multiple port ranges according to your needs (e.g.: 27015-27020 for Source servers).

---

7️⃣ Open ports in the firewall#

For each allocated port range, open them in UFW:

sudo ufw allow 25565:25575/tcp
sudo ufw allow 25565:25575/udp

Check the firewall status:

sudo ufw status

---

8️⃣ FAQ & common issues#

• "Wings is not connected" error? Check that Wings is started with systemctl status wings. Make sure the FQDN in the node matches the VPS IP.

• Can't access the panel? Check that ports 80 and 443 are open (ufw allow 80/tcp). Check that nginx is running (systemctl status nginx).

• Game servers won't start? Check that ports are allocated in the panel AND open in the firewall. Check logs with docker logs <container_id>.

• Database connection error? The script may have been run multiple times. Reinstall the system and run the script on a freshly installed VPS.

• How to update Pterodactyl? Check the official documentation at pterodactyl.io for panel and Wings updates.

---

✅ Conclusion#

Your Pterodactyl panel is now installed and ready to use! You can create your first game servers from the web interface. Don't forget to install the "Eggs" (server templates) for the games you want to host. For more information, check the official Pterodactyl documentation.