Aller au contenu principal

Guide d'hébergement mutualisé

Ce guide explique comment installer LeadHub sur un compte d'hébergement mutualisé cPanel classique. Aucun SSH, aucun terminal, aucun accès root requis.

Ce que vous utiliserez​

  • Gestionnaire de fichiers cPanel (ou FTP)
  • MySQL Databases cPanel
  • Cron Jobs cPanel
  • Un navigateur web

Étape 1 — Créer la base de données​

  1. Dans cPanel, cliquez sur MySQL Databases.
  2. Créez une nouvelle base de données, ex. username_leadhub.
  3. Créez un nouvel utilisateur, ex. username_lhuser, avec un mot de passe fort.
  4. Ajoutez l'utilisateur à la base de données et accordez Tous les privilèges.
  5. Notez : nom de la BDD, nom d'utilisateur, mot de passe et hôte (généralement localhost).

Étape 2 — Téléverser les fichiers​

Option A — Gestionnaire de fichiers :

  1. Allez dans cPanel → Gestionnaire de fichiers.
  2. Naviguez vers public_html/ (ou un sous-répertoire si vous voulez LeadHub dans un dossier).
  3. Cliquez sur Téléverser et téléversez le fichier ZIP de LeadHub.
  4. Après le téléversement, faites un clic droit sur le ZIP → Extraire vers public_html/.

Option B — FTP :

  1. Utilisez FileZilla ou tout autre client FTP.
  2. Connectez-vous à votre hébergement avec vos identifiants FTP.
  3. Téléversez tous les fichiers du dossier LeadHub extrait directement dans public_html/.

⚠️ Assurez-vous que index.php se trouve directement dans public_html/ — pas dans un sous-dossier.

Étape 3 — Définir les permissions​

Dans le Gestionnaire de fichiers cPanel :

  1. Sélectionnez le dossier storage/ → clic droit → Modifier les permissions → définissez à 755, cochez Inclure les sous-répertoires.
  2. Faites de même pour bootstrap/cache/.

Étape 4 — Exécuter l'installeur​

Ouvrez votre navigateur et accédez à :

https://votredomaine.com/install

Complétez l'assistant en suivant le guide d'installation.

Étape 5 — Configurer le Cron Job​

  1. Dans cPanel, cliquez sur Cron Jobs.
  2. Sous Ajouter un nouveau Cron Job, définissez Paramètres courants sur « Chaque minute (* * * * *) ».
  3. Dans le champ Commande, saisissez : 
    /usr/bin/php /home/votreutilisateur/public_html/cron.php >> /dev/null 2>&1

    Remplacez votreutilisateur par votre nom d'utilisateur cPanel réel et ajustez le chemin si LeadHub est dans un sous-répertoire.

  4. Cliquez sur Ajouter un nouveau Cron Job.

Étape 6 — Vérifier que le Cron s'exécute​

Après 2-3 minutes, dans le panneau Super Admin de LeadHub, allez dans Santé du système. Le statut de la file d'attente doit afficher vert. S'il affiche « file d'attente non active », vérifiez le chemin du cron.

Installation dans un sous-répertoire​

Si vous souhaitez LeadHub sur votredomaine.com/leadhub/ plutôt qu'à la racine :

  1. Téléversez les fichiers dans public_html/leadhub/.
  2. Lors de l'installation, définissez l'URL de l'application sur https://votredomaine.com/leadhub.
  3. Le chemin du cron devient /home/votreutilisateur/public_html/leadhub/cron.php.

Installation sur un sous-domaine​

Pour installer LeadHub sur app.votredomaine.com :

  1. Dans cPanel → Domaines (ou Sous-domaines), créez app.votredomaine.com pointant vers ex. public_html/leadhub/.
  2. Téléversez les fichiers dans public_html/leadhub/.
  3. Définissez l'URL de l'application sur https://app.votredomaine.com.

Vérification de la version PHP​

Si votre cPanel dispose du Gestionnaire MultiPHP :

  1. Allez dans Gestionnaire MultiPHP.
  2. Trouvez votre domaine/sous-domaine.
  3. Sélectionnez PHP 8.4 (ou la version 8.x la plus élevée disponible).
  4. Enregistrez.

Problèmes courants avec cPanel​

ProblèmeSolution
.htaccess ne fonctionne pasActivez mod_rewrite via cPanel → Apache Handlers, ou contactez l'hébergeur
Erreur 500 Interne du ServeurVérifiez storage/logs/laravel.log dans le Gestionnaire de fichiers
Extension PHP manquantecPanel → Sélectionner la version PHP → activez l'extension manquante
File d'attente non activeVérifiez le chemin du cron — utilisez le chemin exact indiqué dans Santé du système
Permissions de fichiers refuséesDéfinissez storage/ et bootstrap/cache/ à 755 récursivement