Prérequis
- L'accès à DirectAdmin : Premiers pas avec DirectAdmin
- Votre application Node.js, avec son fichier package.json
Ce guide met en ligne une application Node.js, par exemple une application Express, sur votre domaine ou à une adresse comme votredomaine.ca/app, avec la version de Node.js de votre choix. DirectAdmin la démarre et la garde en marche : vous n'avez pas de serveur à gérer. L'outil, Setup Node.js App, s'affiche en anglais.
1Créer l'application
Dans DirectAdmin, section Outils, cliquez sur Setup Node.js App, puis sur CREATE APPLICATION, et remplissez le formulaire :
Node.js version- La liste s'ouvre sur 10.24.1, une très vieille version : choisissez-en une récente, comme 22.16.0 ou 24.1.0
Application mode- Production pour une application en ligne ; Development, choisi au départ, sert aux essais. Ce choix règle la variable NODE_ENV
Application root- Le dossier de votre application, par exemple monapp : DirectAdmin le crée dans votre compte, à côté du dossier domains, hors de public_html
Application URL- Votre domaine, suivi d'un chemin comme monapp. Sans chemin, l'application répond à l'adresse du domaine et y prend la place de votre site
Application startup file- Le fichier qui démarre votre application, par exemple app.js
Passenger log file- Facultatif : le champ commence par votre dossier personnel ; ajoutez par exemple logs/passenger.log pour y garder les erreurs de votre application
Cliquez sur CREATE. DirectAdmin crée le dossier et y place un app.js d'exemple : ouvrez votre adresse, la page affiche « It works! » suivi de la version de Node.js.
2Envoyer vos fichiers
Avec le gestionnaire de fichiers ou en FTP, placez les fichiers de votre application dans son dossier, celui de Application root, et remplacez l'app.js d'exemple. Laissez de côté le dossier node_modules : les modules s'installent à l'étape suivante.
3Installer les modules
- Dans Setup Node.js App, la liste WEB APPLICATIONS montre votre application : cliquez sur son crayon, dans la colonne Actions.
- Sous Detected configuration files, votre package.json apparaît : cliquez sur Run NPM Install.
- Attendez une minute ou deux, le temps que les modules s'installent.
4Redémarrer et vérifier
Cliquez sur RESTART, en haut de la fiche de l'application, puis sur OPEN, à côté de l'adresse : votre application s'affiche. Refaites RESTART après chaque changement de fichiers, sinon l'ancienne version continue de tourner.
Variables d'environnement
Une clé d'API ou un mot de passe de base de données ne doit pas rester dans votre code. Sous Environment variables, cliquez sur ADD VARIABLE, entrez son nom et sa valeur, puis cliquez sur SAVE et sur RESTART : votre application la lit dans process.env.
Arrêter ou supprimer l'application
Dans la liste WEB APPLICATIONS, la colonne Status indique si l'application tourne, et les icônes de la colonne Actions l'arrêtent, la redémarrent, la modifient ou la suppriment. Dans la fiche de l'application, STOP APP l'arrête et DESTROY la supprime.
Questions fréquentes
Ce message peut s'afficher même quand les modules sont bien installés. Cliquez sur RESTART, puis ouvrez votre adresse : si l'application répond, tout va bien. Sinon, indiquez un Passenger log file et lisez-y l'erreur.
Elle sert dans un terminal SSH, que l'Hébergement Web Mutualisé n'offre pas. Run NPM Install et RESTART font le même travail depuis DirectAdmin.
Celles de votre compte d'hébergement : jusqu'à 8 cœurs de processeur et 4 Go de mémoire, partagés avec votre site. Pour une application plus lourde, voyez notre page serveur Node.js, sur un VPS.