Aller au contenu principal

📥 Installation

PulseHub s'installe via un assistant basé sur le navigateur en deux étapes. Il n'y a rien à compiler et aucun accès en ligne de commande n'est requis.

Étape 1 — Télécharger les Fichiers​

  1. Téléchargez pulsehub-php.tar.gz et extrayez-le sur votre machine locale. Vous obtiendrez un dossier nommé pulsehub-php/.
  2. Téléchargez le contenu de ce dossier (pas le dossier lui-même) vers votre racine web. Sur la plupart des hébergements mutualisés c'est public_html/ ou www/. Sur un VPS c'est là où pointe votre hôte virtuel (ex. /var/www/pulsehub/).

Après le téléchargement, votre racine web devrait ressembler à ceci :

public_html/
├── index.php
├── .htaccess
├── cron.php
├── install/
├── app/
├── public/
├── config/        ← vide à ce stade, créé pendant l'installation
└── data/

Installation en sous-répertoire : Si vous voulez PulseHub à https://votredomaine.com/support/ plutôt qu'à la racine, téléchargez les fichiers dans public_html/support/. Le fichier .htaccess gère le chemin automatiquement.

Étape 2 — Lancer l'Installateur de Base de Données​

Ouvrez votre navigateur et naviguez vers :

https://votredomaine.com/install/

Installateur — Étape 1 : Configuration Base de Données​

Remplissez vos identifiants MySQL :

ChampDescription
Hôte de Base de DonnéesGénéralement localhost. Sur certains hébergeurs c'est une adresse IP — consultez la documentation de votre hébergeur.
PortPar défaut 3306. Ne le changez que si votre hébergeur utilise un port non standard.
Nom de Base de DonnéesLe nom de la base que PulseHub doit utiliser. Elle sera créée automatiquement si votre utilisateur MySQL a le privilège CREATE DATABASE.
Utilisateur Base de DonnéesLe nom d'utilisateur MySQL qui a accès complet à la base ci-dessus.
Mot de Passe Base de DonnéesLe mot de passe pour cet utilisateur.

Cliquez sur Connecter et Créer les Tables →

Installateur — Étape 2 : Compte Administrateur​

ChampDescription
Nom de l'Espace de TravailLe nom de votre organisation, affiché dans la barre latérale.
Votre NomLe nom d'affichage du premier utilisateur administrateur.
Adresse EmailUtilisée pour se connecter. Doit être un format email valide.
Mot de PasseMinimum 8 caractères. Stocké comme un hash bcrypt — jamais en texte clair.
Confirmer le Mot de PasseDoit correspondre exactement.

Cliquez sur Créer le Compte et Terminer →

Étape 3 — Se Connecter​

Cliquez sur Aller sur PulseHub → sur l'écran de succès, ou naviguez vers https://votredomaine.com/. Entrez l'email et le mot de passe que vous venez de créer.

Post-Installation : Verrouiller l'Installateur​

L'installateur se désactive automatiquement une fois que config/database.php existe. Par précaution supplémentaire, vous pouvez supprimer entièrement le répertoire install/ après la configuration en utilisant le Gestionnaire de Fichiers de votre panneau d'hébergement ou votre client FTP.

Vérifier une Installation Réussie​

Après connexion vous devriez voir :

  • La barre latérale avec Boîte de Réception, Contacts, Canaux, Automatisations, Analytiques, Paramètres
  • Le nom de votre espace de travail et votre nom en bas de la barre latérale
  • La boîte de réception affichant « Sélectionnez une conversation » (vide — pas encore de messages)

Installation Nginx (VPS Uniquement — Ignorez en Hébergement Mutualisé)​

Utilisateurs d'hébergement mutualisé : Votre hébergeur gère déjà la configuration du serveur web. Cette section est uniquement pour VPS ou serveurs dédiés exécutant Nginx. Vous pouvez l'ignorer entièrement.

Si vous exécutez Nginx + PHP-FPM, copiez la configuration exemple fournie :

server {
    listen 80;
    server_name votredomaine.com;
    root /var/www/pulsehub;
    index index.php;

    location ~ ^/(config|app|data)/ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Puis activez le site et rechargez Nginx (terminal VPS) :

sudo ln -s /etc/nginx/sites-available/pulsehub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx