Production rescue guide

Your app works locally but breaks in production

Local development hides production realities: environment variables, network config, file paths, service availability, and process management all differ between your machine and a server.

What is probably broken

The app runs on your machine but the server returns errors, crashes on start, or serves a blank page.

What production should look like

The app running on a production server with correct config, stable process, and live URL on your domain.

STEP 01

Compare local and production environments

Find what your machine has that the server does not.

  • Check Node, npm, and OS version differences.
  • List all environment variables set locally but absent on the server.
  • Identify hardcoded file paths that only work on your machine.

STEP 02

Fix the server environment

Replicate the local environment on the production server.

  • Install the same Node version and package manager.
  • Add all missing environment variables to the server.
  • Replace hardcoded paths with relative or configurable paths.

STEP 03

Deploy and verify

Build on the server, start the process, and test every integration.

  • Run a clean production build on the server.
  • Start the app as a managed process with auto-restart.
  • Test signup, database writes, file uploads, and external API calls.

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 diagnoses why apps work locally but fail in production and ships them to a working live URL.

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

Deploy my app

Related guides