Déployer sa première application Node.js sur NeoHeberg

L'hébergement d'applications exécute votre code Node.js sans vous donner un accès root. Vous fournissez un projet qui démarre avec une commande connue, écoute sur le port fourni et écrit ses erreurs dans la sortie standard. Tout le reste est géré par la plateforme.

Préparer le projet

Un projet minimal contient package.json, un fichier principal et ses dépendances :

{
  "name": "mon-app",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^5.0.0"
  }
}

Le serveur doit lire le port depuis l'environnement et écouter sur toutes les interfaces :

const express = require("express");
const app = express();
const port = Number(process.env.PORT ?? 3000);

app.get("/", (_req, res) => res.send("En ligne"));
app.get("/health", (_req, res) => res.json({ status: "ok" }));

app.listen(port, "0.0.0.0", () => {
  console.log(`Listening on ${port}`);
});

Ne codez jamais le port en dur : sur l'hébergement d'applications, la valeur est fournie par la plateforme. Gardez aussi une route de santé simple pour vérifier le démarrage.

Créer le service

Dans le dashboard, choisissez un service d'hébergement d'applications, puis Node.js et une version (22 LTS ou 24 selon ce qui est proposé). Donnez un nom explicite, par exemple mon-app. Notez la RAM, le disque et les allocations affichés : ils limitent ce que l'application peut consommer.

Envoyer les fichiers

Utilisez le gestionnaire de fichiers du panneau Pterodactyl pour téléverser une archive du projet, puis extrayez-la à la racine du serveur. Le fichier principal par défaut est index.js ; si votre entrée s'appelle autrement, ajustez MAIN_FILE dans les variables d'environnement.

N'envoyez pas node_modules : la commande de démarrage exécute npm install lorsque package.json est présent. Envoyez en revanche package-lock.json pour des versions reproductibles.

Démarrer et vérifier

Lancez le serveur depuis le panneau, puis ouvrez la console :

• npm install doit se terminer sans erreur ;
• la ligne Listening on ... doit apparaître ;
• la route /health doit répondre {"status":"ok"} via l'allocation fournie.

Si le processus redémarre en boucle, lisez la première erreur, pas la dernière. Les causes courantes sont un fichier principal absent, une dépendance non déclarée ou un port codé en dur.

Mettre à jour

Téléversez les nouveaux fichiers, redémarrez le serveur et vérifiez à nouveau /health et les logs. Pour les variables sensibles, utilisez les variables d'environnement du panneau, jamais un fichier commité dans Git.