wiki/Catalogue-Self-Hosted/apps/app-pelican-panel.md

---
title: Pelican Panel
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, gaming, game-server, panel, minecraft, php, fork, pterodactyl]
confidence: high
contested: false
sources:
  - 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\|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)

```yaml
# 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

```bash
# 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

- [Site officiel](https://pelican.dev/)
- [Repository GitHub](https://github.com/pelican-oss/pelican)
- [Documentation](https://pelican.dev/docs)
- [Migration guide Pterodactyl](https://pelican.dev/docs/migrating/from-pterodactyl)
- [Discord communautaire](https://discord.gg/pelican-panel)

## Pages Liées
- [[cat-gaming]] — Catégorie parente
- [[app-pterodactyl]] — Le parent historique
- [[app-crafty-controller]] — Panel Minecraft
- [[app-linuxgsm]] — Alternative CLI
- [[app-traefik]] — Reverse proxy HTTPS
- [[recettes-docker-compose]] — Templates
- [[securisation-home-lab]] — Bonnes pratiques