Node.js-App bei Hostinger per GitHub deployen: der Ratgeber

Diese Website läuft auf Hostinger, per Git-Anbindung direkt aus unserem GitHub-Repository. Kein manuelles Hochladen, kein FTP, kein ZIP-Ordner — ein Push auf den richtigen Branch, und wenige Minuten später ist die neue Version live. So richten wir es auch für unsere Kundenprojekte ein. Hier ist der Weg dorthin, inklusive einem Fehler, der uns selbst passiert ist.

Voraussetzungen

• Ein Hostinger-Paket mit Node.js-Hosting (ab dem Business-Plan verfügbar)
• Ein GitHub-Repository mit einer funktionierenden package.json (build- und start-Skript)
• Eine Domain, die bereits mit dem Hosting-Paket verbunden ist

Schritt 1: Node.js-Anwendung in hPanel anlegen

Im hPanel unter "Websites" die passende Domain öffnen und den Bereich "Node.js" aufrufen. Dort eine neue Anwendung anlegen: Node-Version wählen (am besten die gleiche LTS-Version, mit der auch lokal entwickelt wird), Application-Root festlegen und die Domain zuweisen, unter der die App später erreichbar sein soll.

Schritt 2: GitHub-Repository verbinden

In der neu angelegten Anwendung gibt es einen Git-Bereich: dort die Repository-URL und den gewünschten Branch eintragen (meist main) und den Zugriff auf GitHub autorisieren. Ab diesem Moment zieht Hostinger bei jedem Deploy genau diesen Branch.

Schritt 3: Install- und Start-Befehle festlegen

Hostinger installiert die Abhängigkeiten anhand der package.json und führt anschließend das build- und start-Skript aus. Bei einer Next.js-App sieht das minimal so aus:

{
  "scripts": {
    "build": "next build",
    "start": "next start"
  }
}

Den Start-Befehl übernimmt danach der in Hostinger integrierte Node-Loader — die App läuft als eigener Prozess hinter dem Webserver, nicht als klassisches PHP-Hosting.

Schritt 4: Automatisches Redeploy bei jedem Push

Im Git-Bereich lässt sich "Auto Deploy" aktivieren. Danach löst jeder Push auf den gewählten Branch automatisch einen neuen Build und Neustart der Anwendung aus — kein manuelles Hochladen mehr nötig, auch nicht für kleine Textänderungen.

Die Stolperfalle, die uns selbst erwischt hat

Genau das ist uns bei dieser Seite passiert: Nach einem ganz normalen Feature-Push stand gunico-crown.de plötzlich mit einem "Internal Server Error" da — obwohl der Build lokal und auch auf Vercel ohne Probleme durchlief. Der Blick in die hPanel-Logs zeigte die Ursache: Next.js suchte intern nach dem Paket @swc/helpers, konnte es aber nicht finden.

Der Grund: @swc/helpers steckte nur transitiv über next im Lockfile, nicht als eigene Zeile in den dependencies. Bei einem lokalen pnpm-Install wird das meist automatisch sauber verlinkt — auf Hostingers Umgebung wurde das Paket dadurch aber nicht zuverlässig gefunden, und der komplette Node-Prozess stürzte schon beim Start ab.

Die Lösung war unspektakulär: das Paket explizit als direkte Abhängigkeit eintragen, damit es garantiert mit installiert und verlinkt wird.

{
  "dependencies": {
    "@swc/helpers": "0.5.15"
  }
}

Fünf Dinge, die wir aus echten Deployments gelernt haben

• pnpm nutzen, aber das Lockfile committen — Hostinger installiert exakt das, was dort steht, nicht das, was gerade aktuell wäre.
• Pakete, die ein Framework intern braucht (wie @swc/helpers bei Next.js), lieber explizit eintragen statt sich auf automatisches Hoisting zu verlassen.
• Die Node-Version in hPanel exakt auf die lokale Entwicklungsversion setzen — Versionssprünge sind eine häufige, unnötige Fehlerquelle.
• Nach jedem Deploy zuerst die App-Logs in hPanel prüfen, nicht nur die Startseite im Browser — ein Absturz zeigt sich dort zuerst.
• Umgebungsvariablen zentral in hPanel pflegen, nicht im Repository — sonst landen Zugangsdaten im Git-Verlauf.

Wann lohnt sich das?

Für kleine bis mittlere Next.js- oder Node-Projekte ist das eine solide, günstige Alternative zu spezialisierten Hosting-Plattformen — vor allem, wenn ohnehin schon ein Hostinger-Paket für andere Domains vorhanden ist. Bei sehr hohem Traffic oder wenn Serverless- und Edge-Funktionen gebraucht werden, lohnt sich eher ein Blick auf spezialisierte Plattformen.

Sie möchten das nicht selbst einrichten? Wir übernehmen Node.js-Deployments bei Hostinger für unsere Kundenprojekte, inklusive GitHub-Anbindung — als Hostinger-Partner geben wir den Empfehlungsrabatt dabei direkt an Sie weiter.