Comment installer Pterodactyl sur un VPS en 2026 : le guide complet

Pterodactyl Panel est le panel open source le plus utilisé pour gérer des serveurs de jeux. Que vous hébergiez du Minecraft, du FiveM, du Rust ou n'importe quel autre jeu, Pterodactyl vous offre une interface web moderne pour tout contrôler. Dans ce guide, découvrez comment installer Pterodactyl sur un VPS étape par étape avec un VPS HelloServ.

🎯 Pourquoi utiliser Pterodactyl pour gérer ses serveurs de jeux ?

Pterodactyl s'est imposé comme la référence pour l'hébergement de serveurs de jeux. Voici pourquoi :

• Interface web moderne : gérez vos serveurs depuis un navigateur, sans ligne de commande
• Isolation Docker : chaque serveur tourne dans un conteneur isolé pour la sécurité et la stabilité
• Multi-jeux : Minecraft, FiveM, Rust, CS2, Garry's Mod, ARK, Palworld, et des dizaines d'autres
• Gestion des utilisateurs : créez des comptes avec des permissions granulaires pour vos admins
• API complète : automatisez tout via l'API REST
• Open source et gratuit : aucun coût de licence

⚙️ Prérequis : quel VPS choisir pour Pterodactyl ?

Pterodactyl nécessite un VPS avec des ressources suffisantes pour faire tourner le panel et les serveurs de jeux. Voici les configurations recommandées :

👉 Les VPS Ryzen HelloServ sont particulièrement adaptés grâce à leur haute fréquence mono-thread, idéale pour les serveurs de jeux. L'Anti-DDoS Pro inclus protège aussi bien le panel que vos serveurs.

Système d'exploitation recommandé

Pterodactyl supporte officiellement :

• Ubuntu 22.04 LTS (recommandé, le plus documenté)
• Debian 12 (alternative stable)
• AlmaLinux 9 (si vous préférez RHEL)

🚀 Installation de Pterodactyl Panel (étape par étape)

L'installation se décompose en deux parties : le Panel (interface web d'administration) et Wings (le daemon qui gère les serveurs de jeux).

Étape 1 : Préparer le système

Connectez-vous à votre VPS en SSH et mettez à jour le système :

apt update && apt upgrade -y

Étape 2 : Installer les dépendances

Pterodactyl nécessite PHP 8.1+, MySQL/MariaDB, Nginx et Composer :

apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg
add-apt-repository -y ppa:ondrej/php
apt update

apt install -y php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} 
  mariadb-server nginx tar unzip git redis-server

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Étape 3 : Créer la base de données

mysql -u root -p

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'votre_mot_de_passe_securise';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit

Étape 4 : Télécharger et installer le Panel

mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl

curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/

cp .env.example .env
composer install --no-dev --optimize-autoloader

php artisan key:generate --force
php artisan p:environment:setup
php artisan p:environment:database
php artisan migrate --seed --force
php artisan p:user:make

La dernière commande crée votre compte administrateur. Notez bien vos identifiants.

Étape 5 : Configurer Nginx

Créez le fichier de configuration Nginx pour le panel :

server {
    listen 80;
    server_name votre-domaine.fr;
    root /var/www/pterodactyl/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ .php$ {
        fastcgi_split_path_info ^(.+.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param PHP_VALUE "upload_max_filesize = 100M 
 post_max_size = 100M";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
        fastcgi_buffers 8 16k;
        fastcgi_buffer_size 32k;
    }
}

Étape 6 : Configurer les permissions et le worker

chown -R www-data:www-data /var/www/pterodactyl/*

# Configurer le cron
crontab -e
# Ajouter : * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

# Configurer le queue worker (systemd)
php artisan p:environment:queue-service

🐳 Installation de Wings (le daemon)

Wings est le composant qui exécute réellement les serveurs de jeux via Docker.

Étape 1 : Installer Docker

curl -fsSL https://get.docker.com | bash
systemctl enable --now docker

Étape 2 : Installer Wings

mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
chmod u+x /usr/local/bin/wings

Étape 3 : Configurer Wings depuis le Panel

1. Connectez-vous à votre panel Pterodactyl
2. Allez dans Admin > Locations, créez une location (ex: "Lyon, France")
3. Allez dans Admin > Nodes, créez un nouveau node
4. Renseignez les ressources (RAM, disque, ports)
5. Copiez le fichier de configuration généré
6. Collez-le dans /etc/pterodactyl/config.yml sur votre VPS

Étape 4 : Démarrer Wings

# Test en premier plan
wings --debug

# Si tout fonctionne, configurez le service systemd
systemctl enable --now wings

🔒 Sécuriser votre installation

Votre panel est maintenant fonctionnel. Voici les étapes de sécurisation indispensables :

SSL avec Let's Encrypt

apt install certbot python3-certbot-nginx
certbot --nginx -d votre-domaine.fr

Firewall UFW

ufw allow 22/tcp     # SSH
ufw allow 80/tcp     # HTTP
ufw allow 443/tcp    # HTTPS
ufw allow 8080/tcp   # Wings
ufw allow 2022/tcp   # Wings SFTP
ufw allow 25565:25600/tcp  # Ports serveurs de jeux (adapter selon vos besoins)
ufw allow 25565:25600/udp
ufw enable

Fail2ban

apt install fail2ban
systemctl enable --now fail2ban

🎮 Créer votre premier serveur de jeux

Tout est installé. Voici comment créer votre premier serveur Minecraft :

1. Dans le panel, allez dans Admin > Servers > Create New
2. Renseignez le nom, l'utilisateur propriétaire et le node
3. Allouez les ressources (RAM, CPU, disque)
4. Choisissez le Nest "Minecraft" et l'Egg correspondant (Paper, Forge, Fabric...)
5. Définissez la version du jeu et les ports
6. Cliquez sur Create Server

Docker télécharge automatiquement l'image et prépare le serveur. En quelques secondes, votre serveur Minecraft est prêt à accueillir des joueurs.

💡 Optimisations et bonnes pratiques

Performances

• Swap : Configurez 2-4 Go de swap pour éviter les crashs OOM
• Allocations : Ne sur-allouez pas la RAM, Docker gère la mémoire efficacement
• Backups : Activez les sauvegardes automatiques dans les paramètres de chaque serveur

Eggs personnalisés

Pterodactyl fonctionne avec des "Eggs" : des configurations pré-faites pour chaque jeu. La communauté propose des centaines d'Eggs sur GitHub pour des jeux comme FiveM, Rust, Palworld, CS2 et bien d'autres.

Mises à jour

Gardez votre installation à jour pour la sécurité et les nouvelles fonctionnalités :

# Mettre à jour le Panel
cd /var/www/pterodactyl
php artisan down
curl -L https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz | tar -xzv
composer install --no-dev --optimize-autoloader
php artisan migrate --seed --force
php artisan up

# Mettre à jour Wings
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
chmod u+x /usr/local/bin/wings
systemctl restart wings

🏆 Pourquoi installer Pterodactyl sur un VPS HelloServ ?

Les VPS HelloServ sont parfaitement adaptés pour Pterodactyl :

• CPU Ryzen haute fréquence : performances optimales pour les serveurs de jeux
• Stockage NVMe Gen4 : démarrage et chargement ultra-rapides
• Anti-DDoS Pro 10 Tbps+ : votre panel et vos serveurs sont protégés
• Templates Ubuntu/Debian : système pré-installé, prêt à configurer
• Bande passante illimitée : pas de limitation pour vos joueurs
• Support 24/7 : assistance en français si vous bloquez

❓ FAQ – Pterodactyl sur VPS

Combien de serveurs de jeux puis-je héberger sur un seul VPS ?

Cela dépend de vos ressources. Avec un VPS 8 Go de RAM, comptez 2-3 serveurs Minecraft ou 1 serveur FiveM + 1 serveur léger. Chaque serveur consomme entre 2 et 6 Go de RAM selon le jeu et les joueurs.

Pterodactyl est-il difficile à installer ?

L'installation demande des bases en administration Linux (SSH, Nginx, MariaDB). En suivant ce guide étape par étape, comptez environ 30 à 45 minutes pour une installation complète. Le support HelloServ peut vous assister si vous bloquez.

Puis-je utiliser Pterodactyl pour autre chose que des jeux ?

Oui. Des Eggs existent pour héberger des bots Discord, des applications Node.js, des bases de données ou même des serveurs vocaux Mumble/TeamSpeak. Pterodactyl est un gestionnaire de conteneurs Docker avant tout.

Panel et Wings doivent-ils être sur le même VPS ?

Pas obligatoirement. Vous pouvez installer le Panel sur un VPS et Wings sur un autre pour séparer l'administration des serveurs de jeux. Pour débuter, un seul VPS suffit.

Quelle alternative à Pterodactyl ?

Pelican Panel est un fork de Pterodactyl en développement actif. Les deux sont très proches. Pterodactyl reste le plus mature et le mieux documenté en 2026.