Bolt deployment rescue

Bolt.new app works in preview but deploy fails

Bolt.new runs your app in its own environment. Moving to a real server exposes missing dependencies, wrong build commands, and absent environment variables.

What is probably broken

The app runs fine in Bolt.new but crashes on a real server with missing modules, build failures, or a process that will not stay alive.

What production should look like

The same Bolt.new app running on your own server, with a working build, stable process, and live URL on your domain.

STEP 01

Capture what Bolt.new was doing

Bolt.new handles install, build, and start automatically. You need to replicate those settings.

  • Find the package.json build and start scripts.
  • Note the Node version Bolt.new uses.
  • List every environment variable the app references in code.

STEP 02

Recreate the build on your server

Install dependencies and run the build with production env vars present.

  • Install all dependencies with the same package manager Bolt.new uses.
  • Run the production build and fix any missing dependency or type errors.
  • Load environment variables from the server, not from a `.env` file in the repo.

STEP 03

Start the process and keep it alive

A VPS needs a process manager. The app will not stay running on its own.

  • Use PM2, Docker, or your deploy panel to start the app.
  • Capture logs and confirm the app responds on the expected port.
  • Add the domain, enable HTTPS, and run a full smoke test.

Quick check

Is your app production-ready?

If you cannot tick all five, we can fix it. Send us the repo and we handle the rest.

  • ?Custom domain with HTTPS
  • ?Environment variables configured
  • ?Database wired and backed up
  • ?Auto-deploy on push
  • ?Smoke tested and live

Free checklist

Deploying this yourself?

Get the exact 5-step checklist we run before every deploy. No fluff, just the things that actually break.

No spam. Your email is only used to send the checklist.

Done-for-you deploy

RepoAssistant takes a Bolt.new app from preview-only to a production server you own, with domain and backups.

Fixed price per repo. 24h delivery or full refund. No hourly billing.

Deploy my app

Related guides