Files
wiki/Catalogue-Self-Hosted/apps/app-pelican-panel.md
T
2026-06-09 18:40:21 +02:00

7.1 KiB

title, created, updated, type, tags, confidence, contested, sources
title created updated type tags confidence contested sources
Pelican Panel 2026-06-07 2026-06-07 app
catalogue
gaming
game-server
panel
minecraft
php
fork
pterodactyl
high false
https://selfh.st/apps/?tag=Gaming
https://github.com/pelican-oss/pelican
https://pelican.dev/

🎛️ Pelican Panel

Fork communautaire de Pterodactyl, avec une interface web réécrite en Svelte, un système d'extensions, et un cycle de release plus rapide — l'évolution moderne du panel de référence.

Métadonnée Valeur
Site web https://pelican.dev/
GitHub https://github.com/pelican-oss/pelican
License MIT
Langage PHP (Laravel 11) / TypeScript (Svelte UI) / Node.js (Wings daemon)
Étoiles 286
Dernière MAJ 2026-05-25
Catégorie cat-gaming

Description

Pelican Panel est né en 2024 d'un fork de app-pterodactyl initié par des contributeurs frustrés par la lenteur de l'évolution de Pterodactyl Panel (UI vieillissante, bugs persistants, cycle de release de plusieurs mois). Le projet reprend la base Laravel/PHP mais réécrit l'intégralité du frontend en Svelte/TypeScript : interface plus rapide, plus réactive, support natif du dark mode, et un système de themes/plugins natif qui ouvre l'extension communautaire. Le daemon Wings reste compatible (les Eggs sont interchangeables) — la migration d'un Pterodactyl existant vers Pelican est documentée et faisable en quelques heures.

Les points différenciants par rapport à Pterodactyl : (1) UI moderne Svelte 5 avec rechargement quasi-instantané, (2) système d'extensions (hooks PHP) testé par la communauté (ex : intégration Discord Rich Presence, alertes Grafana, billing Pterodon), (3) API REST plus complète, (4) support natif de Docker Compose file upload (l'utilisateur peut coller un docker-compose.yml et le déployer), (5) support natif S3 / Backblaze / MinIO pour backups, (6) dashboarding intégré (CPU/RAM/Réseau par node), et (7) cycle de release mensuel avec des changelogs détaillés.

Le point d'attention : Pelican reste jeune (~1.5 ans), l'écosystème de thèmes/plugins est plus maigre que Pterodactyl, et la compatibilité ascendante avec Pterodactyl Eggs a été cassée à plusieurs reprises. Pour un nouveau déploiement : c'est un excellent choix. Pour une migration d'un Pterodactyl en production stable : tester sur un environnement staging d'abord.

Cas d'usage typique : un hébergeur de serveurs de jeux qui veut une UI plus moderne et des features récentes (intégration Docker Compose, plugins custom), sans réécrire tout depuis zéro. La communauté Pelican est plus petite que Pterodactyl mais plus active sur Discord et GitHub.

Installation

Docker Compose (méthode officielle)

# docker-compose.yml
version: '3.8'

services:
  panel:
    image: ghcr.io/pelican-oss/panel:latest
    container_name: pelican-panel
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./data/var:/app/var
      - ./data/nginx:/etc/nginx/http.d
      - ./data/certs:/etc/letsencrypt
      - ./data/logs:/app/storage/logs
    environment:
      APP_URL: "https://panel.example.com"
      APP_TIMEZONE: "Europe/Paris"
      APP_SERVICE_AUTHOR: "[email protected]"
    depends_on:
      - database
      - cache

  database:
    image: mariadb:11
    container_name: pelican-db
    restart: unless-stopped
    volumes:
      - ./data/db:/var/lib/mysql
    environment:
      MARIADB_DATABASE: panel
      MARIADB_USER: pelican
      MARIADB_PASSWORD: ChangeM3_PELICAN
      MARIADB_RANDOM_ROOT_PASSWORD: "yes"

  cache:
    image: redis:7-alpine
    container_name: pelican-redis
    restart: unless-stopped

  wings:
    image: ghcr.io/pelican-oss/wings:latest
    container_name: pelican-wings
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/containers:/var/lib/docker/containers:ro
      - ./data/wings:/etc/pelican
    depends_on:
      - panel

Migration depuis Pterodactyl

# Sur l'host Pterodactyl
cd /var/www/pterodactyl
php artisan down
cd /var/www && sudo mv pterodactyl pterodactyl-backup
git clone https://github.com/pelican-oss/panel.git pelican
cd pelican && cp ../pterodactyl-backup/.env .env
composer install --no-dev
php artisan migrate
php artisan pelican:convert-nests  # convertit les Eggs Pterodactyl
php artisan up

Configuration

  • Identique à Pterodactyl : Nodes, Allocations, Eggs, Nests — tout est compatible.
  • Themes : activer un theme depuis l'admin → Appearance (ex : thème sombre « midnight »).
  • Plugins : Marketplace intégré (péllican-oss/plugins) — installer Discord Rich Presence, S3 backup étendu, etc.
  • Reverse proxy : Traefik/Caddy devant, comme Pterodactyl.
  • API : /api/v1/... (compatible Pterodactyl), avec quelques endpoints en plus (/api/v1/extensions/...).
  • Sauvegardes : dans Settings → Backups, ajouter un storage driver (local, S3, B2, MinIO).
  • OAuth : Discord, Google, GitHub configurables en 2 minutes.

Alternatives

Open Source

  • app-pterodactyl — Le parent, plus mature et plus stable, mais UI plus datée.
  • app-crafty-controller — Minecraft uniquement, plus simple.
  • app-linuxgsm — CLI pure, pas de panel web.
  • Pterodactyl 2.0 (à venir) — Réécriture officielle prévue, calendrier flou.
  • Yatopia — Ancien fork, déprécié.

Propriétaires

  • CubeCoders AMP — Concurrent propriétaire mature, multi-plateforme.
  • Multiplay (Unity) — Panel historique payant.
  • Hosting providers (BisectHosting, Nodecraft, etc.) — Offres commerciales utilisant souvent Pterodactyl sous le capot.

Sécurité

  • Héritage Pterodactyl : mêmes bonnes pratiques : HTTPS obligatoire, Wings isolé, Fail2ban.
  • Extensions : chaque plugin a accès à l'API. Vérifier la source, signer les extensions en SHA-256.
  • API rate limit : Pelican expose un rate limit natif par token (nouveauté par rapport à Pterodactyl 1.x), bien l'activer.
  • Migrations : les conversions de DB (Pterodactyl → Pelican) sont irréversibles sans restore backup. Toujours sauvegarder avant.
  • Mise à jour : cycle mensuel, suivre la branche release/v1.x.x du repo.
  • Reverse proxy : ne pas exposer le port Wings (8080) en HTTP public — il est en HTTPS, mais derrière un firewall/VPN c'est mieux.

Ressources

Pages Liées