Installation
LeadHub s'installe entièrement via un assistant basé sur le navigateur. Pas de SSH, pas de terminal, pas de Composer.
Avant de commencer
✅ Confirmez que votre serveur répond aux prérequis ✅ Créez une base de données MySQL et un utilisateur (notez les identifiants) ✅ Ayez votre clé de licence prête (depuis votre achat CodeCanyon) ✅ Disposez d'un accès FTP/cPanel File Manager pour téléverser les fichiers
Étape 1 — Téléverser les fichiers
- Téléchargez le package LeadHub depuis CodeCanyon → Téléchargements.
- Extrayez le fichier ZIP sur votre ordinateur.
- Téléversez l'intégralité du contenu du dossier extrait vers la racine web (ex.
public_html/) via FTP ou le Gestionnaire de fichiers cPanel.
⚠️ Ne téléversez pas le dossier externe lui-même — téléversez son contenu afin que
index.phpse trouve directement danspublic_html/.
Étape 2 — Définir les permissions de fichiers
Sur l'hébergement mutualisé, elles sont généralement définies automatiquement, mais vérifiez :
| Chemin | Permission |
|---|---|
storage/ | 755 (récursivement) |
bootstrap/cache/ | 755 |
public/ | 755 |
Étape 3 — Ouvrir l'assistant d'installation
Accédez à votre domaine dans un navigateur :
https://votredomaine.com/install
Si vous voyez une page blanche ou une erreur, vérifiez que mod_rewrite est activé et que .htaccess est présent à la racine.
Étape 4 — Vérification des prérequis
L'assistant vérifie automatiquement tous les prérequis PHP. Les éléments défaillants s'affichent en rouge avec une brève explication. Corrigez tous les éléments en rouge avant de continuer.
Étape 5 — Configuration de la base de données
Saisissez vos identifiants de base de données :
| Champ | Description |
|---|---|
| Hôte de la BDD | Généralement localhost ou 127.0.0.1 |
| Port de la BDD | Généralement 3306 |
| Nom de la BDD | La base de données que vous avez créée |
| Utilisateur BDD | L'utilisateur de la base de données |
| Mot de passe BDD | Le mot de passe de l'utilisateur |
Cliquez sur Tester la connexion pour vérifier, puis sur Suivant.
Étape 6 — Paramètres de l'application
| Champ | Description |
|---|---|
| URL de l'application | Votre domaine, ex. https://votredomaine.com |
| Nom de l'application | Affiché dans l'onglet du navigateur et les e-mails |
| Fuseau horaire | Votre fuseau horaire principal |
Étape 7 — Clé de licence
Saisissez le Code d'achat (clé de licence) de votre achat CodeCanyon. L'assistant le valide en ligne.
Étape 8 — Compte super administrateur
Créez le premier compte super administrateur :
| Champ | Remarques |
|---|---|
| Nom | Votre nom complet |
| Utilisé pour se connecter | |
| Mot de passe | Minimum 8 caractères |
⚠️ Sauvegardez ces identifiants — c'est le compte administrateur racine de toute la plateforme.
Étape 9 — Configuration du Cron Job
L'assistant affiche la commande cron exacte pour votre serveur. Copiez-la et ajoutez-la dans votre panneau d'hébergement :
* * * * * /usr/bin/php /home/username/public_html/cron.php >> /dev/null 2>&1
Sur cPanel : Cron Jobs → Ajouter un nouveau Cron Job → Chaque minute → collez la commande.
Étape 10 — Terminer
Cliquez sur Terminer l'installation. L'assistant écrit le fichier .env et exécute les migrations. Une fois terminé, vous êtes redirigé vers la page de connexion Super Admin sur /super-admin.
Après l'installation
- Connectez-vous sur
/super-adminavec les identifiants que vous venez de créer. - Créez votre premier Locataire.
- Connectez-vous au panneau d'administration du locataire sur
/admin(oulocataire.votredomaine.com/admin).
Dépannage
| Problème | Solution |
|---|---|
Page blanche sur /install | Vérifiez que .htaccess existe et que mod_rewrite est activé |
| « Échec de la connexion à la base de données » | Vérifiez les identifiants ; assurez-vous que l'utilisateur BDD a tous les privilèges |
| Bloqué à la vérification des prérequis | Installez l'extension PHP manquante via cPanel → PHP Extensions |
| Erreur 500 après installation | Vérifiez storage/logs/laravel.log via le Gestionnaire de fichiers |
➡ Voir aussi : Guide d'hébergement mutualisé