Aller au contenu principal

Assistant d'Installation

LeadHub s'installe entièrement via votre navigateur web. Il n'y a pas de ligne de commande, pas de terminal, pas de SSH. Vous téléchargez les fichiers, ouvrez une URL et suivez cinq étapes simples. Ce guide vous accompagne tout au long du processus du début à la fin.

Durée totale : environ 10 à 20 minutes.

Avant de Commencer​

Assurez-vous que votre serveur répond aux exigences listées dans le guide de Configuration Requise. En particulier, confirmez que :

  • PHP 8.3 ou supérieur est actif pour votre domaine
  • Vous disposez d'une base de données MySQL (ou MariaDB) — ou vous pouvez en créer une (instructions ci-dessous)
  • Vos répertoires storage/ et bootstrap/cache/ sont accessibles en écriture
  • Vous disposez d'environ 500 Mo d'espace disque libre

Étape 1 — Téléchargez les Fichiers LeadHub sur Votre Serveur​

Téléchargez le package​

Après l'achat de LeadHub, téléchargez le package ZIP depuis votre email de confirmation d'achat ou depuis la page Téléchargements d'Envato. Le fichier sera nommé quelque chose comme leadhub-v1.0.0.zip.

À l'intérieur du ZIP vous trouverez tout ce dont LeadHub a besoin — incluant le dossier vendor/ (toutes les dépendances PHP), le CSS et JavaScript pré-compilés, et l'installateur lui-même. Vous n'avez rien à installer séparément.

Téléchargement via le Gestionnaire de Fichiers cPanel (méthode la plus simple)​

C'est l'approche recommandée pour la plupart des utilisateurs en hébergement mutualisé.

  1. Connectez-vous à votre compte cPanel.
  2. Cliquez sur File Manager dans la section Files.
  3. Naviguez vers le dossier où vous souhaitez installer LeadHub. Typiquement :
    • public_html/ si vous voulez LeadHub sur votre domaine principal (ex. https://votredomaine.com)
    • Un sous-répertoire comme public_html/leadhub/ si vous le souhaitez dans un chemin
    • Un dossier addon domain dédié si vous avez configuré un addon domain (recommandé — voir le Guide d'Hébergement Mutualisé pour les détails)
  4. Cliquez sur Upload dans la barre d'outils.
  5. Téléchargez le fichier leadhub-v1.0.0.zip.
  6. Après la fin du téléchargement, retournez dans File Manager, faites un clic droit sur le fichier ZIP et choisissez Extract.
  7. Extrayez-le dans le bon dossier.

Téléchargement via FTP​

Si vous préférez le FTP (en utilisant un programme comme FileZilla ou Cyberduck) :

  1. Connectez-vous à votre serveur avec vos identifiants FTP (hôte, nom d'utilisateur, mot de passe, port 21).
  2. Naviguez vers le dossier de destination sur votre serveur (le panneau droit dans FileZilla).
  3. Glissez le dossier leadhub décompressé depuis votre ordinateur vers le dossier du serveur.
  4. Attendez que tous les fichiers finissent de se télécharger. Cela peut prendre 5 à 15 minutes selon votre vitesse de connexion.

Astuce : Il est plus rapide de télécharger le fichier ZIP via File Manager et de l'extraire sur le serveur que de télécharger des milliers de fichiers individuels via FTP.

Étape 2 — Définissez les Permissions des Fichiers​

LeadHub doit pouvoir écrire dans certains dossiers. Les « permissions » sont des paramètres qui contrôlent qui est autorisé à lire, écrire ou exécuter des fichiers. Vous devez définir les dossiers suivants au niveau de permission 755.

Dans le Gestionnaire de Fichiers cPanel :​

  1. Ouvrez File Manager et naviguez vers votre dossier LeadHub.
  2. Faites un clic droit sur le dossier storage et choisissez Change Permissions.
  3. Définissez-le à 755 et assurez-vous que la case « Recurse into subdirectories » est cochée.
  4. Cliquez sur Change Permissions.
  5. Répétez pour le dossier bootstrap/cache (définissez à 755).

C'est tout ce que vous avez à faire. L'installateur tentera également de corriger automatiquement les permissions s'il trouve des problèmes.

Étape 3 — Ouvrez l'Installateur dans Votre Navigateur​

Ouvrez votre navigateur web et visitez :

https://votredomaine.com/install

Remplacez votredomaine.com par votre vrai nom de domaine. Si vous avez installé LeadHub dans un sous-répertoire, incluez-le dans le chemin (ex. https://votredomaine.com/leadhub/install).

L'installateur se chargera et vous guidera à travers cinq étapes. Chaque étape est un formulaire simple — remplissez-le et cliquez sur Suivant.

Si vous voyez une erreur 404 « Page non trouvée » : Vérifiez que vos fichiers sont dans le bon dossier et que le fichier public/.htaccess a été correctement téléchargé. Sur cPanel, confirmez également que mod_rewrite est activé.

Si vous voyez une page blanche : PHP n'est probablement pas activé pour ce dossier, ou la version PHP est trop ancienne. Retournez dans cPanel → MultiPHP Manager et confirmez que PHP 8.3 est sélectionné.

Installateur Étape 1 — Bienvenue et Vérification des Prérequis​

La première page de l'installateur est la Vérification des Prérequis. LeadHub scanne automatiquement votre serveur et vous montre une liste de contrôle.

Vous verrez des coches vertes pour ce qui fonctionne correctement et des avertissements rouges pour ce qui nécessite attention :

  • Version PHP — doit être 8.3 ou supérieur
  • Extensions PHP — vérifie les 13 extensions requises (pdo, pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, bcmath, fileinfo, curl, zip, gd)
  • Permissions des Répertoires — vérifie que storage/ et bootstrap/cache/ sont accessibles en écriture

Que faire en cas d'échec​

Version PHP trop basse : Allez dans cPanel → MultiPHP Manager → changez votre domaine en PHP 8.3. Revenez et rafraîchissez la page.

Une extension PHP manque : Allez dans cPanel → Select PHP Version → trouvez l'extension manquante → cochez la case → Save. Revenez et rafraîchissez.

Un répertoire n'est pas accessible en écriture : Allez dans cPanel → File Manager → clic droit sur storage ou bootstrap/cache → Change Permissions → définissez à 755 et récursez dans les sous-répertoires. Revenez et rafraîchissez.

Une fois que tout affiche une coche verte, cliquez sur « Next: Database » pour continuer.

Installateur Étape 2 — Configuration de la Base de Données​

Cette étape connecte LeadHub à votre base de données MySQL. Vous devrez remplir quatre champs :

ChampQue saisir
Database HostGénéralement localhost ou 127.0.0.1 — laissez la valeur par défaut sauf indication contraire
PortGénéralement 3306 — le port MySQL standard. Laissez tel quel.
Database NameLe nom de la base de données MySQL que vous avez créée (voir ci-dessous)
Database UsernameL'utilisateur MySQL que vous avez créé (voir ci-dessous)
Database PasswordLe mot de passe de cet utilisateur MySQL

Après avoir rempli ces champs, l'installateur testera immédiatement la connexion lorsque vous cliquerez sur « Next: Admin Account ».

Comment créer une base de données MySQL dans cPanel​

  1. Dans cPanel, cherchez MySQL Databases (dans la section Databases).
  2. Sous « Create New Database », tapez un nom (ex. leadhub) et cliquez sur Create Database. Note : cPanel préfixera automatiquement votre nom d'utilisateur (ex. monuser_leadhub).
  3. Sous « MySQL Users » → « Add New User », créez un nom d'utilisateur et un mot de passe fort. Cliquez sur Create User.
  4. Sous « Add User to Database », sélectionnez l'utilisateur et la base de données, puis cliquez sur Add.
  5. Cochez « All Privileges » et cliquez sur Make Changes.

Vous avez maintenant une base de données prête. Retournez à l'installateur et saisissez les informations.

Installateur Étape 3 — Compte Administrateur​

Cette étape crée le premier compte administrateur. Remplissez :

ChampQue saisir
Your NameVotre nom complet (ex. « Marie Dupont »)
Email AddressVotre adresse email — ce sera votre identifiant de connexion
PasswordUn mot de passe fort (au moins 8 caractères)
Confirm PasswordLe même mot de passe
Workspace NameLe nom de votre organisation ou espace de travail

Qu'est-ce qu'un Workspace ?

Un workspace est le compte de votre organisation dans LeadHub. Tout dans LeadHub — leads, pipelines, membres d'équipe, automatisations — appartient à un workspace. Lors de la première installation, un workspace est créé automatiquement pour vous. Vous êtes défini comme propriétaire avec les permissions Super Admin complètes.

Cliquez sur « Next: License » lorsque vous avez terminé.

Installateur Étape 4 — Licence​

Cette étape vous permet d'entrer votre code d'achat Envato pour activer votre licence.

Pour trouver votre code d'achat :

  1. Connectez-vous à votre compte Envato Market / CodeCanyon.
  2. Allez dans votre profil → Downloads.
  3. Trouvez LeadHub dans votre liste d'achats.
  4. Cliquez sur « Download » → « License certificate & purchase code ».
  5. Copiez le code d'achat (format : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Collez-le dans le champ License Key et cliquez sur « Next: Finish ».

Vous pouvez aussi ignorer cette étape en laissant le champ vide. Vous pourrez ajouter votre clé de licence plus tard dans Paramètres → Licence.

Installateur Étape 5 — Finalisation​

C'est l'étape finale. Vous verrez un résumé de vos choix de configuration. Cliquez sur « Install LeadHub » pour commencer.

L'installateur effectuera automatiquement les opérations suivantes :

  1. Écriture du fichier de configuration (.env) — stocke votre connexion à la base de données et les paramètres de base.
  2. Exécution des migrations — crée toutes les tables de base de données nécessaires.
  3. Insertion des données initiales — insère les rôles et permissions par défaut.
  4. Création de votre compte administrateur — avec les détails fournis à l'Étape 3.
  5. Création de votre workspace — vous configure comme propriétaire.
  6. Liaison du dossier de stockage — rend les fichiers téléchargés accessibles depuis le navigateur.
  7. Mise en cache de la configuration — accélère l'application.

Ce processus prend environ 30 à 90 secondes. Une fois terminé, vous serez redirigé vers /admin où vous pourrez vous connecter.

L'installation est terminée.

Liste de Vérification Post-Installation​

1. Configurez le Cron Job (CRITIQUE)​

Sans le cron job, vos automatisations ne fonctionneront pas et les emails ne seront pas envoyés.

php /home/votrenomdutilisateur/leadhub/cron.php >> /dev/null 2>&1

Cela doit s'exécuter chaque minute. Voir le Guide d'Hébergement Mutualisé pour les instructions détaillées.

2. Configurez l'Email​

Allez dans Paramètres → Email dans le panneau d'administration. Entrez vos détails SMTP et cliquez sur « Send Test Email » pour vérifier.

3. Téléchargez Votre Logo et Configurez Votre Marque​

Allez dans Paramètres → Branding. Téléchargez votre logo, définissez le nom de votre application et choisissez vos couleurs.

4. Créez Votre Premier Pipeline​

Allez dans Pipelines dans la barre latérale. Créez un pipeline et ajoutez des étapes.

5. Connectez Votre Première Source de Leads​

Allez dans Lead Sources dans la barre latérale. Connectez votre première source.

Comment Relancer l'Installateur​

Si quelque chose ne va pas, vous pouvez relancer l'installateur en supprimant le fichier de verrouillage. Dans File Manager, naviguez vers storage/ et supprimez installed.lock. Puis visitez à nouveau https://votredomaine.com/install.

Avertissement : Relancer l'installateur après une installation complète écrasera votre fichier .env et relancera les migrations. Il est plus sûr de sauvegarder votre base de données d'abord.

Dépannage​

ProblèmeCause probableSolution
« Page not found » en visitant /installFichiers au mauvais endroit ou mod_rewrite inactifVérifiez l'emplacement des fichiers ; confirmez que public/.htaccess a été téléchargé
Page blancheErreur PHP ou mauvaise version PHPPassez à PHP 8.3 dans cPanel MultiPHP Manager
« Cannot connect to database » à l'Étape 2Mauvais identifiants de base de donnéesVérifiez le nom (incluez le préfixe cPanel), l'utilisateur et le mot de passe
Avertissements rouges pour les extensionsExtensions PHP non activéesAllez dans cPanel → Select PHP Version, activez les extensions manquantes
Avertissement « storage is not writable »Permissions incorrectesDéfinissez storage/ à 755 récursivement dans File Manager
L'installateur bloque sur « Installing... »Limite mémoire PHP trop basseRafraîchissez ; vérifiez la limite mémoire PHP (au moins 128 Mo)
Redirigé vers /admin mais connexion impossibleSession non sauvegardéeVérifiez que storage/framework/sessions/ existe et est accessible en écriture
Erreur « installation failed »Connexion à la base de données perdue ou erreur d'écritureVérifiez vos identifiants ; vérifiez que .env peut être écrit