NOUVEAU Migration gratuite en 24h sur tous les packs d'hébergement
Git, Laravel & Node.js

Déployer une application depuis Git sur NovaHoster

Un site se copie ; une application se construit, se migre et se redémarre. Ce guide reprend là où s’arrête le raccordement du dépôt à Plesk : ce qui doit tourner après chaque déploiement, sur quelle offre, et comment retrouver la version de la veille quand celle du jour casse.

Guide NovaHosterÀ lire avant toute modification

Site ou application : où commence ce guide

Pour un site fait de fichiers prêts à servir, le déploiement par Git se résume à une copie. Le guide pour relier un dépôt à Plesk et dépanner ses erreurs couvre cette partie : clé ou jeton, branche, dossier cible, mode, webhook. La suite suppose ce raccordement fait.

Une application demande davantage : le dépôt ne contient ni les dépendances (vendor, node_modules), ni parfois le code compilé (dist), ni le schéma de base à jour. D’où quatre temps :

  1. Copie des fichiers du commit par Plesk.
  2. Préparation : dépendances, construction.
  3. Base de données : migrations du commit.
  4. Relance : caches, processus, contrôle.

La configuration (.env, variables du panneau Node.js, APP_KEY) a son propre guide : configurer les environnements d’une application Laravel ou Node.js.

Quelle offre pour quelle application

Le déploiement par Git est ouvert sur toutes nos offres d’hébergement, START compris. Ce qui change, c’est ce qui peut tourner après la copie.

Votre applicationOù elle a sa placeCe qui décide
PHP ou Laravel, dépendances incluses dans ce qui est déployéTous les packs, START et WP START comprisRien à lancer : tout est construit avant de pousser
Laravel avec Composer et migrations lancés à chaque déploiementLes offres où l’accès SSH s’ouvre sur demande : BUSINESS et ULTIMATE, WP BUSINESS et WP ULTIMATE, les trois packs e-commerce, les trois formules revendeurCe que contient l’environnement des commandes
Node.js : Express, Next.js, Nuxt, une APIBUSINESS et ULTIMATE, WP BUSINESS et WP ULTIMATE, e-commerce BUSINESS et ULTIMATE, revendeur AGENCY et HOSTERUn processus permanent, avec sa propre mémoire
Docker, service système, outil que nous ne proposons pasUn serveur VPS ou un serveur dédiéL’accès root, absent du mutualisé

Les droits cités ici sont ceux des tableaux des packs d’hébergement et des formules revendeur, qui font foi.

Sans accès SSH, Plesk exécute les commandes d’après déploiement dans un environnement isolé dont la racine est le dossier de l’abonnement, et d’où aucun programme extérieur ne se lance [1]. N’y comptez pas sur Composer ou npm sans l’avoir fait vérifier par le support.

Toutes les versions de PHP sont disponibles sur nos packs, de la plus ancienne à la plus récente. Choisissez dans les paramètres PHP du domaine celle qu’exige votre composer.json : Laravel 13 demande au moins PHP 8.3 [5]. En ligne de commande, php -v dit quelle version répond vraiment.

Construire avant de pousser, ou sur l’hébergement

Avant d’écrire la moindre commande, décidez où se fabrique ce qui part en ligne.

Sur l’hébergement, à chaque déploiement

Le dépôt ne contient que les sources ; une commande installe les dépendances après la copie. Avec un composer.lock, composer install pose exactement les versions qu’il fige ; --no-dev écarte les paquets de développement, et --optimize-autoloader, recommandé en production, accélère le chargement des classes [8]. Encore faut-il que Composer soit joignable là où tournent les commandes.

Sur votre poste ou dans votre intégration continue

Vous construisez ailleurs et poussez le résultat sur une branche réservée à la mise en ligne, production par exemple, que Plesk est seul à déployer ; elle porte en plus le dossier vendor ou le dossier construit. C’est la voie d’un front Vite, React ou Next.js, dont la construction réclame des outils de développement que npm n’installe pas quand NODE_ENV vaut production, et la seule sur une offre sans accès SSH.

Dans les deux cas, versionnez les fichiers de verrouillage, composer.lock et package-lock.json. Côté Node.js, préférez npm ci : il exige le fichier de verrouillage, échoue au lieu de le modifier s’il ne correspond plus au package.json, et repart d’un node_modules vide [9]. L’option --omit=dev écarte les dépendances de développement [10].

Placer l’application dans l’abonnement

Plesk recopie le dépôt tel qu’il est rangé ; c’est la racine du document du domaine qui désigne la partie publique.

LaravelNode.js
Dossier cible du dépôt/httpdocs, la valeur par défautUn dossier de l’abonnement, /httpdocs par exemple
Ce que sert le serveur webLe dossier public : racine du document réglée sur /httpdocs/public [5]La « Racine du document » du domaine [2], à régler sur un sous-dossier comme /httpdocs/public pour que ni le script de déploiement ni son journal ne soient servis
Point d’entréepublic/index.phpLe « Fichier de démarrage d’application », app.js par défaut, dans la « Root d’application » [2]
Écrit par l’application en lignestorage et bootstrap/cache, qui doivent rester inscriptibles [5]Ce que votre code enregistre : téléversements, journaux

Ce que l’application crée en ligne (téléversements, journaux, caches) ne doit jamais exister aussi dans le dépôt : un déploiement le remplacerait par la version du commit. Écartez-le par le .gitignore, et rangez le script de déploiement dans un dossier non servi, deploiement/ par exemple.

Le script d’après déploiement

Dans les paramètres du dépôt, la case « Activer des actions de déploiement supplémentaires » accepte une commande par ligne, relancée à chaque déploiement [1]. Mieux vaut y appeler un seul script versionné avec le code : il se relit en revue, suit l’historique, et le champ de Plesk garde une ligne qui ne change jamais.

Pour Laravel

#!/bin/sh
# deploiement/apres.sh : lancé par Plesk après chaque copie du dépôt
set -e
cd "$(dirname "$0")/.."
exec >> storage/logs/deploiement.log 2>&1
echo "--- $(date '+%Y-%m-%d %H:%M')"

php artisan down --render="errors::503"
composer install --no-dev --optimize-autoloader --no-interaction
php artisan migrate --force
php artisan optimize
php artisan queue:restart   # seulement si l'application a des files d'attente
php artisan up
set -e arrête tout à la première commande en échec : une installation ratée ne débouche pas sur une migration. Le cd ramène à la racine du projet, d’où que Plesk lance le script, et exec garde une trace datée de chaque passage dans un fichier non servi. php artisan migrate --force évite la demande de confirmation que Laravel pose en production avant une opération qui peut détruire des données [6] ; php artisan optimize met en cache configuration, événements, routes et vues en une commande [5].

Dans le champ de Plesk, une seule ligne appelle le script. Avec l’accès SSH ouvert, écrivez le chemin complet :

sh /var/www/vhosts/votre-domaine.tn/httpdocs/deploiement/apres.sh

Dans l’environnement isolé (chroot), où la racine est le dossier de l’abonnement, la ligne s’écrirait sh ./httpdocs/deploiement/apres.sh, mais aucun programme extérieur n’y est joignable [1] : ni php ni Composer ne s’y lancent. Ce script Laravel suppose donc l’accès SSH.

Chaque commande doit pouvoir être rejouée sans dégât : migrate saute les migrations déjà passées, optimize reconstruit ses caches. Une réserve : si le nouveau code exige un paquet que vendor n’a pas encore, artisan down lui-même peut échouer. Le journal le dira ; c’est un argument de plus pour construire avant de pousser.

Pour Node.js

Plesk fait tourner l’application Node.js par Phusion Passenger [13]. Après une copie, deux gestes : installer les dépendances si package.json a changé, puis redémarrer. Le panneau Node.js du domaine offre « Installer NPM », visible dès qu’un package.json est dans la racine de l’application, et « Redémarrer l’app » [2]. En ligne de commande, toucher tmp/restart.txt suffit : Passenger relance l’application en voyant la date changer, à l’arrivée d’une requête et donc pas instantanément [11].

#!/bin/sh
# deploiement/apres.sh : version pour une application Node.js
set -e
cd "$(dirname "$0")/.."
exec >> deploiement.log 2>&1
echo "--- $(date '+%Y-%m-%d %H:%M')"

npm ci --omit=dev
mkdir -p tmp
touch tmp/restart.txt

Si npm n’est pas joignable là où tournent les commandes, construisez hors de l’hébergement et passez par les boutons du panneau : « Installer NPM » puis « Redémarrer l’app » quand package.json a changé, « Redémarrer l’app » seul sinon.

Avec Laravel Toolkit, s’il figure sur votre domaine

Quand cette extension est installée, son onglet Déploiement a sa propre mécanique : mode manuel ou automatique, scénario dont on décoche les étapes inutiles, et script saisi par « Modifier le script », exécuté à chaque mise à jour ; le modifier suppose un accès SSH réglé sur autre chose que « Interdit » [3]. Choisissez l’un ou l’autre mécanisme : les deux à la fois lanceraient deux fois les migrations.

Les migrations : l’étape qu’un commit ne défait pas

Revenir à l’ancien code prend une minute ; revenir à l’ancienne base, non. Une colonne supprimée par une migration emporte ses données, et aucun retour du code ne les rend. Trois précautions :

  • Sauvegarder juste avant une mise en ligne qui migre : Sites Web & Domaines > Gestionnaire de sauvegardes > Sauvegarder [4]. Cette sauvegarde est la vôtre, restaurée par vous depuis Plesk ; celles de nos serveurs servent à reprendre le service après un incident chez nous, pas à rendre votre base d’hier matin.
  • Lire avant d’exécuter : php artisan migrate --pretend affiche les requêtes SQL sans les lancer [6]. À faire en préproduction, sur une copie de la base.
  • Ajouter d’abord, retirer ensuite : une colonne neuve et facultative ne gêne pas l’ancien code ; l’ancienne ne disparaît qu’à une mise en ligne suivante. Le code peut alors revenir en arrière sans toucher à la base.

php artisan migrate:rollback défait le dernier lot, --step=5 un nombre précis [6], si chaque méthode down() rétablit vraiment l’état d’avant. Aucune ne recrée des données supprimées : là, seule la sauvegarde sert.

Le mode maintenance couvre l’intervalle délicat. php artisan down renvoie une page 503 ; avec --render="errors::503", elle est préparée d’avance et servie avant que le framework démarre, ce que Laravel conseille pendant la mise à jour des dépendances ; php artisan up rouvre le site, et les tâches en file d’attente attendent entre les deux [7]. Le script ne commence qu’après la copie : la maintenance protège l’installation et la migration, pas la copie elle-même. S’il s’arrête sur une erreur, le site reste en maintenance plutôt qu’à moitié à jour, et le journal dit pourquoi.

Revenir à la version précédente

La documentation de l’extension Git ne décrit aucun moyen de redéployer un commit antérieur : elle déploie ce qu’elle récupère de la branche choisie [1]. Le retour arrière se fait donc dans Git, et redescend par le chemin habituel.

  1. Repérez le commit fautif dans « Logs de commit », sur la page Git de Plesk [1].
  2. Sur votre poste, annulez-le par un nouveau commit : git revert <identifiant> enregistre un commit qui défait les changements visés, sans réécrire l’historique [12]. Pour un commit de fusion, indiquez le parent à conserver avec -m 1 [12].
  3. Poussez. Avec le webhook et le mode automatique, la correction part seule ; en mode manuel, cliquez sur Déployer.
  4. Si le commit annulé apportait une migration, elle reste appliquée : défaites-la avec migrate:rollback si sa méthode down() le permet, sinon restaurez la sauvegarde prise avant la mise en ligne.

Préférez ce revert à un git reset suivi d’un envoi forcé : le code en ligne est le même, mais aucun commit ne disparaît de l’historique.

Marquez aussi chaque mise en production d’une étiquette (git tag v2026.10.31, puis git push --tags) : un repère de ce qui est en ligne, pour l’équipe comme pour le support.

Une préproduction sur un sous-domaine, reliée au même dépôt

Une erreur se voit mieux sur une copie qui tourne comme la vraie. Sur les packs START, BUSINESS et ULTIMATE, les sous-domaines sont illimités et ne comptent pas dans le nombre de sites. Une préproduction a besoin de sa propre base : START n’en compte qu’une, BUSINESS cinq, ULTIMATE un nombre illimité. Une organisation qui fonctionne avec l’extension Git :

  • preprod.votre-domaine.tn, avec son dépôt Plesk, sa base et son .env : branche preprod, mode automatique ;
  • le domaine principal : branche production, mode manuel ;
  • un webhook par dépôt Plesk, chacun ayant sa propre adresse [1] : un envoi sur preprod ne publie rien sur le domaine principal.

Mettre en production, c’est fusionner preprod dans production puis cliquer sur Déployer : part en ligne exactement ce qui vient d’être essayé. En Node.js, la préproduction est une application de plus, avec sa propre mémoire : vérifiez que les deux tiennent dans les ressources réservées du pack.

Après chaque mise en ligne : cinq contrôles

  1. Le commit affiché sur la page Git de Plesk est celui que vous avez poussé.
  2. Le journal du script (storage/logs/deploiement.log dans l’exemple) se termine sur la dernière commande, sans erreur.
  3. La route de santé : celle de Laravel, /up, répond 200 quand l’application démarre sans exception et 500 sinon [5] ; pour Node.js, écrivez la vôtre.
  4. Un parcours réel : connexion, formulaire, page qui lit la base.
  5. Les processus longs : un worker de file d’attente garde l’ancien code tant qu’il n’a pas redémarré ; Laravel demande de relancer tout service de longue durée après une nouvelle version [5].

Une erreur 500 après un déploiement sans erreur vient de l’application, pas de la copie : le guide pour lire les journaux d’une application en production prend le relais.

Ce que le support peut vérifier pour vous

Livechat et ticket, 7 jours sur 7, en français ou en tunisien. Écrivez-nous avant de bâtir le déploiement pour savoir ce que contient l’environnement des commandes sur votre offre, pour faire ouvrir l’accès SSH, ou si le bouton Node.js manque.

Joignez le domaine, la branche, le script (il ne contient aucun secret) et la fin de son journal. Le guide pour ouvrir une demande de support propose un modèle.

Questions fréquentes

Puis-je construire mon front Vite ou Next.js directement sur l’hébergement ?
Seulement si npm et les outils de développement sont joignables là où tournent les commandes, ce qui n’est pas acquis sans accès SSH. La voie sûre : construire sur votre poste ou en intégration continue, pousser le résultat sur une branche de mise en ligne, et ne laisser à l’hébergement que le redémarrage.
Un déploiement peut-il écraser mon fichier .env ?
Pas s’il n’a jamais été dans le dépôt : la copie n’a aucune version à lui substituer. Le risque vient d’un .env commité par erreur ou d’un envoi FTP par-dessus la version en ligne. S’il a été commité puis retiré du suivi, gardez-en une copie avant le déploiement suivant.
Faut-il lancer les migrations automatiquement à chaque déploiement ?
En préproduction, oui : c’est là qu’une migration doit échouer si elle doit échouer. En production, c’est un choix : automatique si chaque migration ajoute sans retirer et a déjà tourné en préproduction ; sinon, retirez migrate --force du script de production et lancez-la vous-même, juste après la sauvegarde de la base.
Une application Node.js demande-t-elle un serveur VPS ?
Pas forcément : elle tourne sur nos offres à partir de BUSINESS, WP BUSINESS, e-commerce BUSINESS ou revendeur AGENCY, démarrée par Passenger. Le serveur VPS devient nécessaire pour Docker, pour un service système ou pour tout ce qui réclame l’accès root.

Guides liés

Sources techniques

  1. Plesk Obsidian — Utiliser l’hébergement Git distant : modes de déploiement, webhook, actions de déploiement supplémentaires, environnement chrooté, logs de commit (en français)
  2. Plesk Obsidian — Prise en charge de Node.js : racine de l’application, fichier de démarrage, Installer NPM, Redémarrer l’app (en français)
  3. Plesk Obsidian — Laravel Toolkit : onglet Déploiement, script, condition d’accès SSH (en français)
  4. Plesk Obsidian — Créer des sauvegardes (en français)
  5. Documentation Laravel 13 — déploiement : PHP 8.3, dossier public, droits d’écriture, optimize, services longs, route /up
  6. Documentation Laravel 13 — migrations : --force, --pretend, migrate:rollback et --step
  7. Documentation Laravel 13 — configuration : mode maintenance, down --render, up, files d’attente
  8. Composer — interface en ligne de commande : install, composer.lock, --no-dev, --optimize-autoloader
  9. npm — npm ci
  10. npm — configuration : option omit
  11. Phusion Passenger — redémarrer une application, fichier tmp/restart.txt
  12. Git — git revert
  13. Plesk — Node.js dans Plesk : Phusion Passenger sert les applications Node.js (blog de l’éditeur, en anglais)
Cette procédure ne correspond pas à votre écran ?

Les permissions et options visibles peuvent dépendre de votre formule ou de vos droits. Faites vérifier le contexte depuis l’Espace client.

Demander une vérification
Besoin d’un contexte précis ?

Un technicien vous répond à partir de votre situation réelle.

Préparez votre domaine, le message d’erreur et le type d’hébergement. L’Espace client permet d’ouvrir une demande sans exposer d’informations sensibles.