> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/fr/guide-dadministration/admin-guide/installation/installation-wizard.md). # Assistant d'installation Chamilo 3.0 inclut un assistant d’installation web qui vous guide lors de la configuration initiale. L’assistant se lance automatiquement lorsque vous accédez à la plateforme pour la première fois. ## Avant de commencer Assurez-vous que les prérequis suivants sont remplis : 1. Votre serveur satisfait à toutes les [exigences serveur](/3.x/fr/guide-dadministration/admin-guide/installation/server-requirements.md). 2. Vous avez téléchargé une version empaquetée (zip ou tar.gz) de Chamilo. 3. Votre serveur web est configuré pour servir le répertoire `public/` comme racine des documents. 4. Votre fichier `.env` existe et est vide (l’assistant vous guidera pour la configuration de la base de données). ## Étape 1 : Langue d’installation ![Assistant d’installation Étape 1 — sélection de la langue](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-3bb63d9477d7c1c7f6f53c60b1e4a05f9f7ff4b3%2Finstall-step1-language.png?alt=media) La première étape vous permet de sélectionner la langue du processus d’installation. Choisissez votre langue préférée dans la liste déroulante. Si Chamilo détecte une installation existante (pour une mise à niveau), il affichera l’état de la migration et proposera un chemin de mise à niveau plutôt qu’une installation neuve. ## Étape 2 : Vérification des prérequis ![Assistant d’installation Étape 2 — vérification des prérequis affichant la version PHP, les extensions et les permissions des répertoires](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-2538f869c74fe5bde35450d30ea2b1482ba8e59e%2Finstall-step2-requirements.png?alt=media) L’assistant vérifie l’environnement de votre serveur : * La **version PHP** est 8.3, 8.4 ou 8.5 * Les **extensions PHP requises** sont installées (intl, gd, curl, zip, mbstring, xml, etc.) * Les **paramètres PHP recommandés** — `date.timezone` est configuré, limites d’envoi/mémoire suffisantes * Les **permissions des répertoires et fichiers** — `var/`, `config/` et `public/upload/` sont inscriptibles par le serveur web Si certains prérequis ne sont pas remplis, l’assistant affiche des avertissements ou des erreurs. Résolvez-les avant de continuer. ## Étape 3 : Licence ![Assistant d’installation Étape 3 — acceptation de la licence](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-f094fb2fe7a74f43c4e25f4efb0c63049641b5ff%2Finstall-step3-license.png?alt=media) Cette étape affiche la licence GNU/GPLv3. Vous devez cocher la case **« J’accepte »** pour continuer. Facultativement, vous pouvez développer la section **Informations de contact** pour indiquer des détails sur votre organisation (nom, e-mail, société, pays). C’est volontaire et cela aide la communauté Chamilo à comprendre qui utilise la plateforme, mais cela nous permettra aussi de vous contacter *très rarement* au sujet d’événements se déroulant près de chez vous. ## Étape 4 : Paramètres de la base de données ![Assistant d’installation Étape 4 — configuration de la connexion à la base de données](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-2137cbc14608b72e73c11e47e3da98c8129193e9%2Finstall-step4-database.png?alt=media) Saisissez les détails de connexion à votre base de données : | Champ | Description | | -------------------------------------- | ------------------------------------------------------------------------------------------------------ | | **Hôte de la base de données** | Le nom d’hôte ou l’adresse IP de votre serveur de base de données (par ex. `localhost` ou `127.0.0.1`) | | **Port de la base de données** | Par défaut : 3306 pour MySQL/MariaDB | | **Nom de la base de données** | Le nom de la base de données à utiliser (alphanumériques et tirets bas uniquement) | | **Utilisateur de la base de données** | Un utilisateur de base de données disposant de tous les privilèges sur la base indiquée | | **Mot de passe de la base de données** | Le mot de passe de l’utilisateur de la base de données | Cliquez sur **Vérifier la connexion à la base de données** pour tester. L’assistant ne vous laissera pas continuer tant que la connexion n’est pas réussie. Si la base de données existe déjà, un avertissement s’affiche. ## Étape 5 : Paramètres de configuration ![Assistant d’installation Étape 5 — compte administrateur, paramètres du portail et configuration e-mail](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-fb38c8506af225df9cd3154cc64d2c3c823c8bc0%2Finstall-step5-config.png?alt=media) Cette étape combine la création du compte administrateur, les paramètres du portail et la configuration e-mail. ### Compte administrateur | Champ | Description | | ---------------- | ------------------------------------------------------------------------------- | | **Identifiant** | Le nom d’utilisateur de l’administrateur | | **Mot de passe** | Choisissez un mot de passe fort — ce compte a un accès complet à la plateforme | | **Prénom** | Le prénom de l’administrateur | | **Nom** | Le nom de l’administrateur | | **E-mail** | Utilisé pour les notifications système et la réinitialisation des mots de passe | | **Téléphone** | Numéro de contact facultatif | Ces informations d’administrateur seront également utilisées par Chamilo pour renseigner les coordonnées de support : pensez à les reconfigurer dans les paramètres une fois l’installation terminée. ### Paramètres du portail | Champ | Description | | ------------------------------------------------------ | ------------------------------------------------------------------- | | **Langue** | La langue d’interface par défaut | | **Nom du portail** | Le nom de votre plateforme (par ex. « LMS de mon organisation ») | | **Nom court de l’organisation** | Le nom abrégé de votre organisation | | **URL de l’organisation** | Le site web de votre organisation | | **Méthode de chiffrement** | Algorithme de hachage des mots de passe — **bcrypt** est recommandé | | **Autoriser l’auto-inscription** | Oui / Non / Après approbation | | **Autoriser l’auto-inscription en tant que formateur** | Oui / Non | ### Configuration e-mail La section des paramètres e-mail vous permet de configurer le transport de messagerie (SMTP, Amazon SES, Mailjet, etc.) et de tester l’envoi. Voir [Configuration e-mail](/3.x/fr/guide-dadministration/admin-guide/installation/email-configuration.md) pour plus de détails. Tous ces paramètres peuvent être modifiés ultérieurement depuis le panneau d’administration. ## Étape 6 : Dernière vérification avant l’installation ![Assistant d’installation Étape 6 — récapitulatif de tous les paramètres avant l’installation](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-53ef3d6ea7c9ab712af17be93542eeb95fab548a%2Finstall-step6-review.png?alt=media) Cette étape affiche un récapitulatif de tout ce que vous avez saisi, pour relecture : * Identifiants de l’administrateur (le mot de passe est masqué par défaut — cliquez sur l’icône œil pour l’afficher) * Paramètres du portail * Détails de connexion à la base de données Vérifiez attentivement, puis cliquez sur **Install Chamilo** pour lancer l’installation. L’assistant crée toutes les tables de la base de données, insère les données initiales et configure la plateforme. ## Étape 7 : Installation terminée ![Assistant d’installation Étape 7 — achèvement avec conseils de sécurité et lien vers le portail](https://1782708788-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH9SSdrxIKZhpXUU00nEK%2Fuploads%2Fgit-blob-6905f8077e5f60547b2147a6a44de47122a8350a%2Finstall-step7-complete.png?alt=media) Une fois l’installation terminée avec succès, l’assistant affiche : * **Conseils pour bien démarrer** — Il est suggéré de créer votre premier cours pour explorer la plateforme (en tant qu’administrateur, vous devez le faire depuis le panneau d’administration) * **Recommandations de sécurité** : * Rendre le répertoire `config/` en lecture seule (`chmod 0555`) * Supprimer le répertoire `public/main/install/` * Un **lien vers votre portail** pour vous connecter avec les identifiants administrateur que vous venez de créer ## Après l’installation Après avoir terminé l’assistant : * **Supprimer ou restreindre l’accès à l’installateur** -- L’assistant ne doit plus être accessible après l’installation. Chamilo le verrouille généralement automatiquement, mais vérifiez qu’un nouvel accès à l’URL d’installation redirige vers la page de connexion. * **Configurer la livraison des e-mails** -- Voir [Configuration e-mail](/3.x/fr/guide-dadministration/admin-guide/installation/email-configuration.md). * **Mettre en place les sauvegardes** -- Avant d’ajouter du contenu, configurez des sauvegardes automatisées de la base de données et des fichiers (Chamilo ne fournit pas de solution pour cela, mais copier le dossier var/ et la base de données sont les 2 éléments les plus importants). * **Revoir les paramètres de sécurité** -- Voir [Paramètres de sécurité](/3.x/fr/guide-dadministration/admin-guide/platform-settings/security-settings.md). ## Dépannage | Problème | Solution | | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Page blanche à l’URL d’installation | Consultez les journaux d’erreurs PHP. Passez temporairement à `APP_ENV=dev` dans .env pour afficher les erreurs dans le navigateur. | | Échec de la connexion à la base de données | Vérifiez les identifiants, confirmez que la base de données existe, vérifiez que le serveur de base de données autorise les connexions depuis l’hôte du serveur web. | | Erreurs de permission refusée | Assurez-vous que `var/` est inscriptible par l’utilisateur du serveur web. | | Ressources non chargées (pas de CSS/JS) | Exécutez `yarn install && yarn build` pour compiler les ressources frontend. |