Zeltro › So führen Sie ein Bolt.new-Projekt lokal aus

Ein Bolt.new-Projekt auf dem eigenen Rechner ausführen

Läuft Bolt.new lokal? Der Builder nicht, Ihr Projekt schon. Wie Sie ein Bolt-Projekt herunterladen oder von GitHub holen, es auf Ihrem eigenen Computer ausführen, mit der Bolt-Datenbank umgehen und es mit Ihrer eigenen KI weiterbearbeiten.

„Bolt.new lokal ausführen“ kann zweierlei heißen, und die Antworten sind verschieden.

Bolt.new selbst, also der Builder, lässt sich nicht installieren. Er läuft in Ihrem Browser, auf Bolts Servern, mit Bolts KI und Tokens. Sein Open-Source-Geschwister bolt.diy kann mit Ihren eigenen API-Schlüsseln auf Ihrem Rechner laufen, ist aber ein separates Projekt ohne gemeinsame Konten, und das letzte Release erschien im Mai 2025.

Ihr Bolt-Projekt läuft sehr wohl lokal. Bolts eigene Dokumentation zeigt, wie: herunterladen, Node.js installieren, npm install && npm run dev. Darum geht es auf dieser Seite, und um das, was danach kommt: das Projekt am Laufen und in Bewegung zu halten, wenn Sie es nicht mehr in Bolt bauen.

Bolt.newWo die App gebaut wurde
ZIP oder GitHubExport → Download, oder synchronisieren
Ihr ComputerZeltro betreibt es, mit einer lokalen Datenbank
Ihre KIBaut weiter, ohne Credits

Was ein Bolt-Projekt ist#

Bolt baut JavaScript-Apps, meist React auf Vite, und seine Backends sind reines JavaScript. Das ist hier eine gute Nachricht: Ein JavaScript-Projekt lässt sich am leichtesten überall ausführen.

Teil Wo es liegt Im Download enthalten?
Ihr Code Bei Bolt, und auf GitHub, wenn Sie es verbunden haben Ja
Datenbank Bolt Cloud (basiert auf Supabase), falls das Projekt eine hat Nein
Secrets und Umgebungsvariablen Bei Bolt Verlassen Sie sich nicht darauf; prüfen Sie Ihre .env
Hosting Bolt Cloud Nein

Schritt 1: den Code aus Bolt holen#

Es gibt zwei Wege, und der zweite ist besser, wenn Sie weitermachen wollen.

Ein ZIP herunterladen. Öffnen Sie das Projekt, klicken Sie oben links auf seinen Titel, dann auf Export → Download, und entpacken Sie es. In Bolts Worten: „Sie können Ihr Projekt als ZIP-Datei herunterladen, um außerhalb von Bolt mit Ihrem eigenen Code-Editor daran zu arbeiten.“

GitHub verbinden. Klicken Sie in Bolt auf das GitHub-Symbol, melden Sie sich an, installieren Sie Bolts GitHub-App und legen Sie ein Repository für das Projekt an. Es beginnt als privates Repository auf main. Ab dann committet Bolt für Sie: „Jedes Mal, wenn Sie eine Änderung machen, die das Projekt nicht kaputtmacht, erstellt Bolt einen Commit für Sie.“ Außerdem „prüft es GitHub alle 30 Sekunden auf Änderungen außerhalb von Bolt und holt sie herein“, lokale Arbeit und Bolt können also nebeneinander bestehen. Arbeiten Sie lokal auf einem Branch: Ändern beide Seiten im selben Moment etwas, „behält Bolt Ihre Änderungen und überschreibt die GitHub-Version“.

Schritt 2: starten, der schnelle Weg#

Für einen ersten Blick reicht das:

  1. Node.js installieren.
  2. Ein Terminal im Projektordner öffnen.
  3. npm install && npm run dev ausführen.

Das Frontend startet auf dem Port, den sein Dev-Server ausgibt. Hat die App eine Bolt-Datenbank, zeigt sie weiter auf Bolt Cloud oder ist gar nicht verbunden.

Schritt 2, der Weg, der auf Dauer funktioniert#

Der schnelle Weg ist für einmal in Ordnung. Mühsam wird es, wenn es drei solcher Projekte gibt, jedes auf eigenem Port, jedes mit eigener Node-Version, und keines mit einer eigenen Datenbank.

Zeltro ist eine kostenlose lokale Entwicklungsplattform genau dafür. Jedes Projekt läuft in seinem eigenen Container, alle Projekte teilen sich ein MariaDB, Postgres, MongoDB und Redis, und Ihr KI-Agent arbeitet im Projekt. So holen Sie ein Bolt-Projekt von GitHub herüber:

zeltro clone work-directly https://github.com/you/your-bolt-app

Aus einem ZIP: Entpacken Sie es in Ihren Projektordner (standardmäßig ~/zeltro-projects) und übernehmen Sie es:

zeltro setup your-bolt-app

So oder so liest Zeltro die package.json, erkennt das Framework (React, Vue, Next.js, Nuxt, SvelteKit, Astro, Express und mehr) und richtet das Projekt auf Node 22 ein. Ist ein KI-Agent konfiguriert, passt er bei clone außerdem das Repository an Zeltro an. Dann gibt

zeltro status your-bolt-app

seine Adresse auf diesem Rechner und eine LAN-Adresse für Ihr Handy aus. Nichts zu merken, kein Port auszusuchen, und das nächste Bolt-Projekt, das Sie herüberholen, bekommt seine eigene.

In Zeltro lauscht der Dev-Server einer Node-App auf Port 3000, und der Browser erreicht ihn über nginx auf Port 80. Ein Vite-Projekt, das standardmäßig 5173 nutzt, braucht --port 3000 in seinem Dev-Skript und für Hot Reload server.ws.clientPort: 80 (server.hmr.clientPort vor Vite 8.1) in der vite.config. Wenn die Seite oder Hot Reload nicht kommt, liegt es fast immer daran, und Ihr Agent kann es beheben.

Die Zeltro-App: eine Seitenleiste mit Projekten, jedes mit Statusanzeige, lokaler und LAN-Adresse sowie Buttons zum Starten, Stoppen, Bearbeiten und Öffnen
Jedes Bolt-Projekt, das Sie herüberholen, bekommt seine eigene Adresse, ohne dass Sie sich etwas merken müssen.

Schritt 3: die Bolt-Datenbank#

Nutzt das Projekt eine Bolt-Datenbank, entscheiden Sie, wo ihre Daten liegen sollen:

Option 1

In Bolt Cloud lassen

Vorerst, während Sie am Frontend arbeiten. Denken Sie daran, dass lokale Änderungen dann echte Daten treffen.

Option 2

In Supabase übernehmen

Bolt kann die Datenbank über den Tab Advanced beim Datenbank-Symbol an Ihr eigenes Supabase-Konto übergeben. Laut Bolts Dokumentation „erfordert die Übernahme einen Pro- oder Teams-Tarif“. Dann richten Sie die .env der App auf Ihr Projekt aus.

Option 3

In eine lokale Datenbank umziehen

Zeltro betreibt bereits Postgres, MariaDB und MongoDB für jedes Projekt. Holen Sie die Daten heraus und lassen Sie Ihren KI-Agenten sie laden und die Datenschicht Schritt für Schritt darauf umschreiben, gegen eine Datenbank auf Ihrem eigenen Rechner.

Verbinden Sie keine frische Supabase-Datenbank über eine bestehende Bolt-Datenbank, um sie zu „verschieben“: Bolt warnt, dass das Ersetzen der Verbindung „zu Datenverlust führen kann“.

Zeltros Einstellungen, Tab Dienste: zeltro-mariadb, zeltro-redis, zeltro-memcached und phpMyAdmin laufen, jeweils mit ihrer Adresse
Die gemeinsamen Dienste, die jedes Projekt nutzt. Postgres und MongoDB kommen dazu, wenn ein Projekt sie braucht.

Schritt 4: weiterbearbeiten, ohne Bolt-Tokens#

Sobald das Projekt lokal läuft, kann die KI, die es bearbeitet, Ihre eigene sein. Zeltro hat keine eigene KI und keine Tokens zu verkaufen. Es betreibt den Agenten, den Sie wählen (Claude Code, Codex, Antigravity, Qwen Code, Aider, OpenCode oder Hermes), mit einem Abo, das Sie schon haben, einem API-Schlüssel zum Preis des Anbieters oder einem kostenlosen lokalen Modell.

cd ~/zeltro-projects/your-bolt-app
zeltro ai "read AGENTS.md, then add a contact form that saves to the database"

Jedes Projekt hat eine AGENTS.md, die Adresse, Datenbank und Befehle beschreibt, so startet der Agent schon im Bilde. Siehe Eigenen Schlüssel mitbringen, oder rechnen Sie Ihre eigenen Zahlen im Sparrechner durch.

Es heißt auch, dass Sie nicht mehr auf JavaScript beschränkt sind. Braucht die App ein Backend mit Laravel, Django oder FastAPI, bauen Sie es im Ordner daneben, und die beiden Projekte erreichen sich im Netzwerk von Zeltro über ihren Namen.

Die Zeltro-App mit einer Claude-Code-Sitzung neben der Projektliste; sie hat gerade einer Rezept-App ein Suchfeld hinzugefügt und listet die geänderten Dateien auf
Ihr eigener Agent bei der Arbeit, mit Ihrem eigenen Abo, neben Ihren Projekten.

Quellen#

Geprüft am 18. Oktober 2026: Bolts Seiten zu Projekten und Dateien, Git, Datenbank: Advanced und unterstützten Technologien. Tarife und Funktionen ändern sich, prüfen Sie sie also in Ihrem eigenen Konto nach.

Fragen

Kann ich Bolt.new lokal ausführen?

Den Builder nicht: bolt.new läuft im Browser auf Bolts Servern. Sein Open-Source-Geschwister bolt.diy kann lokal laufen, ist aber ein separates Projekt, das sich langsamer entwickelt. Ihr Bolt-Projekt schon: herunterladen oder mit GitHub synchronisieren und dann mit Node.js starten.

Wie führe ich ein Bolt.new-Projekt lokal aus?

Laden Sie es über Export → Download herunter (oder klonen Sie es von GitHub), installieren Sie Node.js und führen Sie dann im Projektordner npm install && npm run dev aus. Damit startet das Frontend. Eine Bolt-Cloud-Datenbank bleibt in Bolt Cloud, bis Sie sie übernehmen oder umziehen.

Kann ich Bolt.new auf meinem Computer installieren?

Eine installierbare Version von bolt.new gibt es nicht. Wenn Sie einen KI-Builder wollen, der auf Ihrem eigenen Computer läuft: Zeltro ist einer. Es läuft lokal, nutzt Ihren eigenen KI-Agenten und baut neben JavaScript auch PHP- und Python-Apps. Siehe den vollständigen Vergleich mit Bolt.new.

Ist die Datenbank im Bolt-Download enthalten?

Nein. Das ZIP ist Ihr Code. Bolts Dokumentation sagt nicht, dass Datenbank oder Secrets enthalten sind, planen Sie sie also separat ein: Übernehmen Sie die Datenbank in Supabase (Pro- oder Teams-Tarif) oder ziehen Sie die Daten in eine Datenbank um, die Sie selbst betreiben.

Kann ich Bolt weiter nutzen, nachdem das Projekt lokal läuft?

Ja, wenn Sie die GitHub-Synchronisierung nutzen. Bolt committet seine Änderungen ins Repository und holt Ihre alle 30 Sekunden herein. Arbeiten Sie lokal auf einem Branch und mergen Sie auf GitHub, denn Bolt führt in der App keine Branches zusammen.

Was kostet Zeltro?

Die Zeltro-App ist kostenlos für den privaten Gebrauch, Hobbyprojekte und zum Lernen, ohne Konto. Ein Unternehmen, das sie nutzt, auch für bezahlte Kundenarbeit, kauft einmalig eine lebenslange kommerzielle Lizenz für US$99.99. Das Kommandozeilen-Tool zeltro ist Open Source (MIT). Separat bezahlen Sie Ihre KI: ein Abo, das Sie schon haben, einen API-Schlüssel mit Abrechnung nach Nutzung, oder gar nichts mit einem lokalen Modell.

Ihre Bolt-App lokal weiterbauen

Installieren Sie Zeltro, holen Sie Ihr Bolt-Projekt von GitHub oder aus einem ZIP herüber und bearbeiten Sie es weiter mit der KI, für die Sie schon bezahlen, oder mit einem kostenlosen lokalen Modell. Privat kostenlos, ohne Konto.

Zeltro installieren Warum ein eigener Schlüssel

Lieber nicht selbst einrichten? Ich übernehme das für Sie.

Geprüft am 2026-10-18. Andere Produkte ändern sich oft – wenn hier etwas nicht mehr stimmt, sagen Sie uns Bescheid und wir korrigieren es.