Commencer
Tous les articlesTUTORIEL · 8 MIN DE LECTURE

Déployer votre application Node.js sur l'hébergement Rivervo (Next.js et Nuxt).

RT
Rivervo Team · Rivervo
·
29 avril 2026
·
Mis à jour le 13 novembre 2026
Node
ON SHARED HOSTING

On pense souvent qu'une application Node.js doit forcément tourner sur un VPS. C'est faux : toutes les offres d'hébergement mutualisé Rivervo proposent Node.js et Python dans le menu du site web, qui lance un processus Phusion Passenger pour votre application derrière le même frontal Apache que vos autres sites.

Ce guide détaille toute la procédure pour les deux frameworks les plus courants : Next.js et Nuxt 3. Le résultat : votre application sur https://votredomaine.fr (ou n'importe quel sous-domaine), exécutée par un vrai processus Node.js, qui survit aux redémarrages et se relance en un clic.

Si vous n'avez jamais déployé d'application Node sur un hébergement mutualisé, l'étape où tout le monde bloque est le fichier de démarrage : Passenger a besoin d'un script d'entrée unique qui lance votre framework. Nous en fournissons un pour chaque framework ci-dessous, à copier-coller sans modification.

Ce qu'il vous faut avant de commencer

  • Une offre d'hébergement Rivervo (n'importe laquelle : les applications Node.js fonctionnent sur toutes les offres)
  • Node.js v20 ou plus récent en local pour compiler votre application
  • Le résultat de la compilation, prêt à être envoyé (nous détaillons cela pour chaque framework)
  • Un accès au gestionnaire de fichiers ou en SFTP à votre compte (les deux fonctionnent)

Vous n'avez pas besoin de root, de sudo, de systemd ni d'une configuration de proxy inverse. Passenger s'occupe de tout cela.

Étape 1 : compiler l'application en local

Vous allez envoyer une application compilée, pas les sources. Le panel installe les dépendances, mais il ne compile pas React et ne lance pas de build Vite. Faites-le d'abord sur votre machine.

Next.js :

npm ci
npm run build

Cette commande produit .next/ (le résultat de la compilation). Ne lancez pas next start ici : nous démarrerons l'application depuis le fichier de démarrage dans un instant.

Nuxt 3 :

npm ci
npm run build

Cette commande produit .output/ (le répertoire de build universel de Nuxt). Même principe : ne lancez rien pour l'instant.

Étape 2 : envoyer les bons fichiers

Inutile d'envoyer node_modules/ : le panel installe les dépendances pour vous. Pas besoin non plus de git ni des caches de build.

Envoyez les fichiers sur votre compte, de préférence dans un chemin en dehors de public_html (par exemple /home/<account>/myapp/). Pourquoi en dehors ? Parce que Passenger monte automatiquement public_html à la racine de l'URL, et y placer le code de votre application l'exposerait.

FrameworkEnvoyerIgnorer
Next.js.next/, public/, package.json, package-lock.json, next.config.js, votre server.cjs (ci-dessous)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, votre server.cjs (ci-dessous)node_modules/, .nuxt/, .git/, les sources pages/, components/

Deux façons d'y déposer les fichiers :

  • Site web → Fichiers → envoyer une archive zip → l'extraire : le plus simple si votre connexion est instable.
  • SFTP (FileZilla, Cyberduck, rsync) : plus rapide pour les déploiements répétés. Le serveur, le port, l'utilisateur et le mot de passe se trouvent dans Site web → SSH et SFTP.

Étape 3 : ajouter le fichier de démarrage

C'est le fichier que Passenger exécute à l'arrivée d'une requête. Placez-le à côté de package.json dans le dossier de votre application.

Pour Next.js : server.cjs

const next = require('next')
const http = require('http')
 
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
 
app.prepare().then(() => {
  http.createServer((req, res) => handle(req, res)).listen(port, () => {
    console.log(`Next.js server listening on port ${port}`)
  })
})

Ce qu'il fait :

  • Charge Next et le fait pointer vers le répertoire courant (où se trouvent .next/ et package.json).
  • Crée un gestionnaire de requêtes à partir du routeur interne de Next.
  • Démarre un serveur HTTP sur le port attribué par Passenger (process.env.PORT).
  • Utilise 3000 par défaut pour les tests en local.

dev est déduit automatiquement de NODE_ENV : choisissez le mode Production dans le panel (nous le ferons à l'étape 4) et Next s'exécute en mode production.

Pour Nuxt 3 : server.cjs

import('./.output/server/index.mjs').then(({ createApp }) => {
  createApp().then(({ app }) => {
    const port = process.env.PORT || 3000
    app.listen(port, () => {
      console.log(`Nuxt server listening on port ${port}`)
    })
  })
})

Ce qu'il fait :

  • Importe dynamiquement .output/server/index.mjs de Nuxt (le point d'entrée produit par npm run build).
  • Utilise createApp() pour créer l'instance du serveur H3.
  • Écoute sur le port attribué par Passenger.

L'import() dynamique est voulu : les modules .mjs ne peuvent pas être chargés avec require(), mais un fichier .cjs peut les importer dynamiquement. C'est la solution la plus propre qui fonctionne avec le lanceur de Passenger.

Étape 4 : créer l'application dans le panel

Ouvrez votre projet → Site web → Node.js et Python → Application Node.js.

ChampValeur
Version20 ou plus récente
ModeProduction
Dossiermyapp dans votre dossier personnel (là où vous avez envoyé les fichiers)
Adressevotredomaine.fr (ou un sous-domaine comme app.votredomaine.fr)
Fichier de démarrageserver.cjs

Cliquez sur Créer. Un environnement Node.js est créé dans ~/nodevenv/myapp/20/.

Installer les dépendances

Une fois l'application créée, cliquez sur Installer les dépendances (npm install) et suivez la sortie. En cas d'échec :

  • Vérifiez que package.json se trouve à la racine de l'application (et non dans un sous-dossier).
  • Pour Next.js : vérifiez que next figure dans dependencies et non dans devDependencies (l'installation de production ignore les dépendances de développement).
  • Pour Nuxt : nuxt doit lui aussi être une dépendance normale.

Ajouter les variables d'environnement

Dans l'application : Paramètres → Variables d'environnement → Ajouter une variable. Le mode Production définit déjà NODE_ENV=production.

Pour les applications Next.js qui lisent des valeurs à l'exécution (URL de base de données, clés d'API), ajoutez-les ici. N'envoyez pas de fichier .env contenant des secrets : les variables d'environnement de l'application sont faites pour cela.

L'enregistrement des paramètres redémarre l'application : les nouvelles variables s'appliquent immédiatement.

Étape 5 : vérifier

Ouvrez l'URL de votre application. Elle doit s'afficher.

Si une page d'erreur Passenger apparaît, dépliez-la et regardez en bas : on y trouve presque toujours une trace d'appels claire. Les deux erreurs les plus fréquentes :

Error: Cannot find module 'next' : npm install n'a pas été exécuté, ou l'a été dans le mauvais dossier. Cliquez de nouveau sur Installer les dépendances (npm install).

Error: ENOENT: no such file or directory, open '.next/...' : vous avez envoyé les sources mais pas le répertoire compilé .next/. Compilez en local et renvoyez-le.

Déployer les mises à jour

Répétez les étapes 1 et 2, puis cliquez sur Redémarrer dans l'application. Concrètement :

1. Compiler en local    npm run build
2. Envoyer              .next/ ou .output/, plus les sources/configs modifiées
3. Panel                Redémarrer l'application

Si vous modifiez package.json, cliquez sur Installer les dépendances (npm install) avant de redémarrer. Vous préférez la ligne de commande ? Site web → Terminal : la fiche de l'application indique la commande pour entrer dans son environnement.

Pièges courants

WebSockets : Passenger gère HTTP/1.1 et HTTP/2. La mise à niveau WebSocket fonctionne pour les routes intégrées de Next.js et de Nuxt. Si vous utilisez un serveur WebSocket séparé (ws, socket.io), il partage le même port et démarre via le même server.cjs, sans configuration supplémentaire.

Envois de fichiers / limites body-parser de next.config.js : la taille maximale par défaut du corps d'une requête dans Passenger est de 10 Mo. Si vous envoyez de gros fichiers, augmentez passenger_max_request_size via un .htaccess dans public_html :

PassengerMaxRequestSize 52428800

(50 Mo en octets.)

Tâches cron : si votre application a besoin de tâches en arrière-plan (envois de newsletter, exports planifiés), ne les exécutez pas dans le processus web. Utilisez Site web → Tâches cron pour appeler directement un script Node :

/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.js

Mémoire des processus : Passenger redémarre votre application si elle dépasse le plafond de RAM du compte (qui dépend de votre offre). Une application Next.js / Nuxt typique consomme moins de 100 Mo au repos. Si vous atteignez les limites, analysez avec process.memoryUsage() et cherchez les fuites avant de conclure qu'il vous faut une offre supérieure.

Domaines personnalisés et HTTPS : l'adresse que vous définissez pour l'application est celle à laquelle Passenger la rattache. Le SSL est automatique, sans configuration supplémentaire. Pour un autre domaine ou un sous-domaine, ajoutez-le d'abord dans Site web → Domaines, puis choisissez-le comme adresse de l'application.

Version de Node : la liste Version affiche toutes les versions installées ; changez-la dans les Paramètres de l'application.

Quand ne pas utiliser l'hébergement mutualisé pour Node

Pour être franc : Node.js sur un hébergement mutualisé convient très bien aux portfolios, blogs, pages marketing, petits frontends SaaS et outils internes. Il atteint ses limites pour :

  • Les API à fort débit (plus de 50 requêtes/s en continu) : vous sentirez le plafond CPU du compte
  • Les applications reposant massivement sur WebSocket, avec des milliers de connexions simultanées
  • Les applications qui lancent des processus de travail (files d'attente, scrapers) : le nombre de processus autorisés par compte rend cela peu pratique
  • Tout ce qui nécessite systemd, Docker ou un accès root

Dans ces cas, notre VPS est le bon choix : accès root complet, votre propre noyau, vous y faites tourner ce que vous voulez. Mais pour la plupart des applications Next.js et Nuxt sans trafic énorme, ce guide suffit.

En bref

  1. npm run build en local
  2. Envoyez .next/ (Next) ou .output/ (Nuxt) + package.json + server.cjs
  3. Site web → Node.js et Python → Application Node.js → le dossier, fichier de démarrage server.cjs, mode Production
  4. Installer les dépendances (npm install), puis Redémarrer

En cas de problème, ouvrez un ticket : collez la page d'erreur Passenger et nous vous indiquerons la ligne en cause.

— L'équipe Rivervo