Een Bolt.new-project op je eigen server publiceren

Om een Bolt.new-project op je eigen server te publiceren koppel je het project aan GitHub of download je het als zip, geef je de code aan het Coolify-paneel op je server, stel je de omgevingsvariabelen in en laat je je domein ernaar wijzen. De documentatie van Bolt zegt hetzelfde: staat de code eenmaal op GitHub, dan kun je publiceren via een andere dienst naar keuze. Kies je de GitHub-route, dan kun je in Bolt blijven werken en komen je wijzigingen vanzelf in de repository.

Bolt richt zich op JavaScript. De ondersteunde stack is Node.js voor de backend en browsergebaseerde frameworks voor de frontend, zonder Python- of PHP-backends. Je project is dus hoogstwaarschijnlijk een gewoon Node-project met een package.json en het heeft niets specifieks voor Bolt nodig om te draaien.

Hoe haal je de code uit Bolt?

Via GitHub

1. Open het project, klik rechtsboven op het GitHub-pictogram, log in met je GitHub-account en verleen de toegang waar om wordt gevraagd.
2. Geef de repository een naam en druk op Create repository.
3. De repository begint als privé op een branch main. Vanaf dan stuurt Bolt elke wijziging ernaartoe.

Als zip

Klik linksboven op de projectnaam en daarna op Download. Een zip is een eenmalige kopie en neemt latere wijzigingen in Bolt niet over. De server publiceert vanuit een Git-repository, dus je zou hem nog in een repository moeten zetten. Uitpakken en npm install && npm run dev uitvoeren is een snelle manier om de code buiten Bolt te zien draaien.

Wat voor project is het?

Het project bepaalt de instellingen, dus controleer de afhankelijkheden in package.json. De rijen voor Next.js, Vite en Astro zijn instellingen die we met Coolify op een echte server hebben geprobeerd.

Routeert een Vite-project pagina's in de browser, zet dan Site type op SPA op de pagina General. Dit overslaan is de gebruikelijke reden dat een geneste pagina bij vernieuwen een 404 geeft.

Stap voor stap

1. Bestel een server via de pagina Next.js VPS. Deze optie wordt met Coolify geleverd, dus je publiceert vanuit hetzelfde paneel, ook als je project geen Next.js is.
2. Kloon de repository en voer npm run build uit. Code die in het voorbeeld van Bolt draait, kan toch een productiebuild laten mislukken, en je kunt dat beter eerst zelf ontdekken dan via de server.
3. Open de map in een codeertool zoals Claude Code of Cursor. Kopieer de rij Plak in je AI-tool van het tabblad Overzicht in je Seturack-paneel en plak die erin. De tool leest de instructies en publiceert, en voegt een alleen-lezen deploy key toe voor de privé-repository.
4. Geef hem de omgevingsvariabelen die je code verwacht en houd de waarden uit de code.
5. Test zodra het HTTPS-adres er is de pagina's, het inloggen en het schrijven van gegevens.
6. Laat een A-record naar het IP-adres van de server wijzen en geef de tool de domeinnaam. Het certificaat wordt automatisch uitgegeven.

Je kunt dit allemaal ook met de hand in Coolify doen, zoals onze Next.js-gids uitlegt. Je hebt root-toegang en je kunt alles vanuit het paneel beheren als je dat liever hebt.

Voorkom dat elke wijziging live gaat

Dit is een detail dat bij Bolt hoort. Omdat het elke wijziging naar de repository stuurt, start met een webhook op main elke prompt een nieuwe build en gaan half afgemaakte experimenten live. Om dat te voorkomen klik je op het GitHub-pictogram, gebruik je Create new branch om op een aparte branch te werken en voeg je samen in main als je klaar bent. De server kijkt alleen naar main, dus bezoekers zien de afgeronde versie.

Wat gebeurt er met Bolt Database?

Bolt Database bewaart je gegevens, aanmelding, bestandsopslag en serverfuncties in Bolt Cloud. De code verhuizen laat dat alles waar het is, dus jij kiest wat er daarna komt.

De sleutels op de pagina Secrets van Bolt zijn voor de serverfuncties ervan. Code die op je server draait, leest ze uit omgevingsvariabelen, dus die voer je daar zelf in.

Veelgestelde vragen

Hoe krachtig moet een server voor een Bolt.new-project zijn?

De verkooppagina raadt minimaal 4 GB RAM, 2 vCores en 40 GB schijf aan. Next.js-builds belasten het geheugen naarmate een project groeit: een project met 85 pakketten mislukte bij 2 GB en werd bij 4 GB wel gebouwd, terwijl een klein project bij 2 GB slaagde. Is het niet genoeg, schaal dan op vanuit je paneel.

Wat kost het per maand?

De aanbevolen minimumgrootte kost ongeveer $6 per maand (inclusief btw), en buiten Turkije betaal je in Amerikaanse dollars. Dagelijkse back-ups zijn bij de prijs inbegrepen en het verkeer is onbeperkt. Je abonnement op Bolt is apart en loopt door als je daar blijft ontwikkelen.

Hoe koppel ik mijn domein?

Laat een A-record naar het IP-adres van de server wijzen, voeg het domein toe aan de app en publiceer opnieuw. Het certificaat wordt automatisch uitgegeven. Ons helpartikel behandelt het record.

Hoe komt een wijziging in Bolt op de server?

Bolt stuurt hem naar GitHub en met een webhook bouwt de server opnieuw bij elke push naar de branch waar hij naar kijkt. Zonder webhook druk je in Coolify op Redeploy.

Kan ik de database verhuizen naar PostgreSQL in Coolify?

Praat je code rechtstreeks via SQL met de database, dan wel. Bolt Database omvat ook inloggen, bestanden en serverfuncties, en gewone PostgreSQL vervangt die niet als je code ervan afhangt. In dat geval vraagt de Supabase-route minder codewijzigingen.

Kant-en-klaar bij Seturack: Next.js, Coolify, Supabase.