From 4ab50b0b206ef7f2494cdc8412326a14ef1db70e Mon Sep 17 00:00:00 2001 From: alexwrite Date: Sun, 14 Dec 2025 11:04:06 +0100 Subject: [PATCH 1/2] Rework prerequisites --- docs/installation/requis.md | 69 +++++++++++++++++++++++++++++++++++-- 1 file changed, 66 insertions(+), 3 deletions(-) diff --git a/docs/installation/requis.md b/docs/installation/requis.md index 0e279ae..0f5868a 100644 --- a/docs/installation/requis.md +++ b/docs/installation/requis.md @@ -136,6 +136,69 @@ Pour un environnement de production, nous recommandons fortement **MariaDB** pou ::: ### Serveur web -ClientXCMS est compatible avec la plupart des serveurs web. Il est recommandé d'utiliser [Apache ou Nginx](./selfhosted) ou un [hébergement Plesk](./plesk). -### Docker -Vous pouvez également installer ClientXCMS via Docker. Pour cela, vous devez disposer de Docker et Docker Compose installés sur votre serveur. Vous pouvez suivre les instructions d'installation via Docker [ici](./docker). + +Le choix du serveur web impacte directement les performances de ClientXCMS. + +#### Nginx (Recommandé) +**Nginx** est le serveur web recommandé pour ClientXCMS grâce à : +- **Performant** pour les fichiers statiques +- **Gestion optimisée** des connexions simultanées +- **Consommation mémoire réduite** +- **Configuration flexible** et moderne + +#### Apache HTTP Server +**Apache 2.4+** reste une alternative viable avec : +- Configuration via fichiers `.htaccess` +- Large compatibilité avec les hébergements partagés +- Modules étendus disponibles + +#### Serveurs d'applications PHP +- **PHP-FPM** (recommandé avec Nginx) +- **mod_php** (avec Apache) + +:::tip Conseil performance +L'association **Nginx + PHP-FPM** offre les meilleures performances pour ClientXCMS en production. +::: + +### Solutions d'installation + +#### Installation manuelle +Guides détaillés par environnement : +- **[Serveur dédié/VPS](./selfhosted)** - Installation complète sur Linux +- **[Hébergement Plesk](./plesk)** - Déploiement via panneau Plesk + +#### Conteneurisation Docker +**Docker** offre un déploiement rapide et isolé : +- **Environnement standardisé** (Nginx, PHP-FPM, MariaDB) +- **Déploiement en quelques minutes** +- **Isolation des dépendances** +- **Facilité de mise à jour** + +👉 [Guide d'installation Docker](./docker) + +### Déploiement automatisé avec Ansible + +**Ansible** offre une solution d'automatisation complète pour le déploiement de ClientXCMS : + +#### Avantages d'Ansible +- **Déploiement en une commande** - Installation complète automatisée +- **Configuration standardisée** - Environnement optimisé et sécurisé +- **Reproductibilité** - Déploiement identique sur tous vos serveurs +- **Gestion des mises à jour** - Automatisation des upgrades +- **Multi-serveurs** - Déploiement simultané sur plusieurs machines + +#### Composants automatisés +- Installation et configuration de **PHP 8.3** avec toutes les extensions +- Configuration de **Nginx + PHP-FPM** optimisée +- Installation et sécurisation de **MariaDB** +- Configuration des **certificats SSL** (Let's Encrypt) +- Mise en place des **tâches cron** et **queues Laravel** +- Configuration des **permissions** et de la **sécurité** + +#### Ressources disponibles +**[Guide de déploiement automatisé](./ansible)** +**[Playbook Ansible officiel sur GitHub](https://github.com/ClientXCMS/ansible)** + +:::tip Recommandation +Pour les déploiements en production ou multi-serveurs, Ansible est la méthode recommandée pour sa fiabilité et sa rapidité. +::: From 8d00b0af28f290d52ffaa159b427ddb2ca41f71d Mon Sep 17 00:00:00 2001 From: Martin DELEBECQUE Date: Sat, 10 Jan 2026 00:16:42 +0100 Subject: [PATCH 2/2] Update package name for Pterodactyl SSO --- docs/extensions/modules/Pterodactyl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/extensions/modules/Pterodactyl.md b/docs/extensions/modules/Pterodactyl.md index 59df9ff..379bf5d 100644 --- a/docs/extensions/modules/Pterodactyl.md +++ b/docs/extensions/modules/Pterodactyl.md @@ -112,7 +112,7 @@ Permettez à vos clients d'accéder à leur panel Pterodactyl en un clic depuis 1. Sur votre VPS, placez-vous dans le dossier du panel : ```bash cd /var/www/pterodactyl - composer require "clientxcms/pterodactyl-sso" + composer require "clientxcms/sso-pterodactyl" ``` 2. Videz le cache : ```bash