Blog · Deploy-Anleitungen

So deployst du eine TanStack-Start-App 2026: Nitro, ein Start-Skript und ein Befehl

Vom Pethost-Team · 10. Oktober 2026 · Aktualisiert 25. Oktober 2026 · 8 Min. Lesezeit

Du hast eine TanStack-Start-App und willst sie auf einem Node-Server unter einer Adresse mit HTTPS online haben. Der Hosting-Guide von TanStack verlangt dafür zwei Dinge von der App: das Nitro-Plugin und ein start-Skript. Sind beide da, schreibt pethost deploy das Dockerfile, baut die App und gibt ihre Adresse aus. Die App, die die TanStack-CLI erstellt, war beim ersten Mal in 29 s gebaut und gestartet.

Was du brauchst, um eine TanStack-Start-App 2026 zu deployen

Drei Dinge: die App, den Befehl pethost und ein Pethost-Konto.

Die App ist hier die, die die TanStack-CLI erstellt, mit Nitro als Deployment-Ziel:

npx @tanstack/cli@latest create my-app --deployment nitro

Das Flag fügt das Nitro-Plugin in die vite.config.ts ein. In einer App, die du schon hast, ergänzt du es so, wie es der Nitro-Teil des Hosting-Guides beschreibt:

import { tanstackStart } from '@tanstack/react-start/plugin/vite'
import { defineConfig } from 'vite'
import { nitro } from 'nitro/vite'
import viteReact from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [tanstackStart(), nitro(), viteReact()],
})

Dann gib der package.json das Skript, das startet, was der Build schreibt. Die CLI legt dort build an, aber kein start:

"scripts": {
  "dev": "vite dev --port 3000",
  "build": "vite build",
  "start": "node .output/server/index.mjs"
}

Der Befehl ist ein Programm, installiert mit einer Zeile. Jeden seiner Befehle findest du in der Referenz der CLI.

curl -fsSL https://pethost.dev/install.sh | sh      # macOS, Linux
irm https://pethost.dev/install.ps1 | iex           # Windows, in PowerShell

Das Konto braucht einen Tarif. Wenn du nicht angemeldet bist, öffnet pethost deploy deinen Browser und meldet dich an. Wenn du noch keinen Tarif hast, zeigt er dir, wo du einen wählst, und wartet.

Die TanStack-Start-App mit einem Befehl deployen

Geh in den Ordner mit der package.json und führ pethost deploy aus. Das ist der ganze Bildschirm, für die App, die die CLI erstellt hat:

$ cd my-app
$ pethost deploy
Name it [my-app]:    it will live at https://my-app.sam.pethost.app
✓ Packed 18 files, 183 KB   (left out node_modules)
✓ Uploaded straight to your machine
✗ /compose.yaml: the project directory has no compose.yaml at its root: add one
✓ Node.js project detected, wrote Dockerfile.
✓ Packed 19 files, 184 KB   (left out node_modules)
✓ Uploaded straight to your machine
✓ Built and started in 29 s
  · wrote compose.yaml for the Dockerfile: the service app, reading .env
✓ app listens on 3000 → https://my-app.sam.pethost.app
  It answers 200.

https://my-app.sam.pethost.app

Wrote .pethost (commit it). Next:   pethost logs -f   ·   pethost open

1. Es fragt nach einer Sache Nach dem Namen des Projekts, dem ersten Wort seiner Adresse. Enter übernimmt den Namen des Ordners.
2. Die Maschine findet nichts zum Ausführen Der Ordner geht direkt auf deine Maschine, ohne node_modules. Die Zeile mit dem Kreuz ist ihre Antwort: Ein Projekt läuft aus einem Dockerfile oder einer Compose-Datei, und der Ordner hat noch keins von beiden.
3. pethost schreibt das Dockerfile Es hat die Skripte build und start in der package.json gelesen und lädt den Ordner erneut hoch.
4. Die Maschine baut und startet es Sie sieht, dass der Server auf 3000 lauscht, und leitet die Adresse dorthin. Dann ruft pethost die Adresse selbst auf und gibt aus, was sie geantwortet hat: 200.

Wir haben die deployte App so aufgerufen, wie es jemand tut, der die Adresse öffnet. Die Startseite und /about antworteten beide mit 200 und auf dem Server gerendertem HTML, und eine Adresse ohne Route antwortete mit 404. Der laufende Server brauchte 43 MB RAM.

Das Dockerfile, das pethost für TanStack Start schreibt

Das ist die Datei, wie sie in den Ordner der App geschrieben wurde, vollständig:

# Written by pethost deploy for this Node.js project: Node 24 (no .nvmrc names another),
# npm installs it (package-lock.json), package.json builds it with "vite build",
# package.json starts it with "node .output/server/index.mjs".
# It is yours now: change it as you like. pethost does not write it again.

FROM node:24
WORKDIR /app

COPY . .

# Every dependency: what builds the project, and may start it, is among the ones for
# development.
RUN --mount=type=cache,target=/root/.npm \
    npm install

RUN npm run build

ENV NODE_ENV=production
CMD ["npm", "run", "start"]

Die ersten Zeilen sagen, was pethost in deinem Ordner gelesen hat. Der Paketmanager ist der, den deine Lockfile nennt, und die Node-Version die, die .nvmrc oder .node-version nennt, oder Node 24, wenn es keine von beiden gibt. Build und Start sind deine beiden Skripte, so wie du sie geschrieben hast.

Ohne das Start-Skript

Eine TanStack-Start-App lässt sich für mehrere Arten von Hosting-Anbietern bauen, also rät pethost nicht, wie deine startet. Ohne start-Skript schreibt es keine Datei und sagt, warum:

$ pethost deploy
Name it [my-app]:    it will live at https://my-app.sam.pethost.app
✓ Packed 13 files, 177 KB
✓ Uploaded straight to your machine
✗ /compose.yaml: the project directory has no compose.yaml at its root: add one
  package.json builds the project and names nothing that starts it (no start script), and what it builds is no site of a kind pethost has a row for.
  Your coding agent writes one in a minute: "Write a Dockerfile for this app".
  Then run pethost deploy again.     How Pethost runs a folder: https://pethost.dev/docs/api/#CreateProject

Füg das Skript hinzu und führ den Befehl noch einmal aus.

Eine Route ändern und neu deployen

Bearbeite eine Route und führ denselben Befehl aus. Der zweite Deploy dauerte 7 s, weil die Maschine die Layer des Builds und den Cache von npm behält:

$ pethost deploy
my-app (.pethost)
✓ Packed 20 files · uploaded · built and started in 7 s
  · wrote compose.yaml for the Dockerfile: the service app, reading .env
  · kept the project's x-pethost
  It answers 200.
https://my-app.sam.pethost.app

Wenn der Build fehlschlägt

Um das zu sehen, haben wir eine Routen-Datei kaputt gemacht. Der Bildschirm zeigt das Log des Builds mit dem Fehler darin, und die letzte Zeile sagt, was alle bekommen, die die Adresse öffnen. Das ist dieser Bildschirm, gekürzt auf drei seiner Zeilen:

$ pethost deploy
my-app (.pethost)
✗ Deploy failed: failed to build: failed to solve: process "/bin/sh -c npm run build" did not complete successfully: exit code: 1
    #9 0.793 Error: Error transforming route file /app/src/routes/about.tsx: SyntaxError: Unexpected token, expected "," (4:19)
  Nothing changed: the version before still runs.

Um bei jedem Push zu deployen, verbinde das Repository einmal mit pethost github sam/my-app. Pethost liest nur die Repositorys, die du seiner GitHub-App freigegeben hast. pethost rollback holt die Version vor der aktuellen zurück, und deine Maschine behält die drei Versionen davor. Ein KI-Agent kann all das über den MCP-Server von Pethost für dich erledigen: wie ein Agent ein Projekt deployt und betreut.

Umgebungsvariablen und deine eigene Domain

Eine Variable, die eine Server-Funktion liest, ist ein Befehl. Er fragt nach dem Wert, ohne ihn anzuzeigen, schreibt ihn in die Datei .env des Projekts auf der Maschine, und spätere Deploys behalten ihn:

pethost env set DATABASE_URL

Jeder Name unter der Domain deines Kontos ist sofort eine Adresse, mit HTTPS. Eine Domain, die dir gehört, braucht einen Befehl und einen DNS-Eintrag:

pethost domain add app.example.com

Der Befehl gibt den Eintrag aus, den du anlegen musst: einen CNAME von deinem Namen auf den Namen deiner Maschine. Das Zertifikat kommt von selbst, sobald der Name auflöst, und erneuert sich selbst.

Was du für den Preis bekommst

Pethost kostet 9,99 € im Monat für alles, was du hostest, mit 2 vCPU, 3 GB RAM und 30 GB Disk. Der Server der App brauchte davon 43 MB RAM, also hat die Maschine Platz für ihre Datenbank, einen Worker und deine anderen Projekte, etwa eine React-Router-App daneben. Es gibt keine Gebühr pro Projekt und nichts nach Verbrauch: Server-Funktionen werden nicht pro Aufruf abgerechnet.

• 9,99 € im Monat für alle deine Projekte, nichts nach Verbrauch
• 29 s zum Bauen und Starten der App, beim ersten Mal
• 7 s für den Deploy danach

Was schon für dich erledigt ist: HTTPS mit Zertifikaten, die sich selbst erneuern, Deploys aus GitHub, nächtliche Backups, 14 Tage aufbewahrt, SSH in jeden Container und jeder Request gezählt, mit den meistaufgerufenen Pfaden und der Fehlerquote der letzten 30 Tage. Die Maschine läuft immer, also wartet eine Server-Funktion nie auf einen Kaltstart. Die Tarife stehen im Teil Preise der Startseite.

Die Bildschirme zeigen Deploys der App, die npx @tanstack/cli@latest create --deployment nitro schreibt, mit TanStack Start 1.168.61, Nitro 3.0.260610-beta und pethost 0.2.1, auf einer Testmaschine von uns, die vorher nichts gebaut hatte. Das Konto darin ist das Beispielkonto, sam.

1. TanStack Start: Hosting
2. TanStack Start: Quick Start
3. pethost, die Kommandozeile von Pethost