[Support Guide] Compiled Build and Deploy Resources -- start here!

Last reviewed by Netlify Support in July 2025

We want to help you build and deploy your site as easily as possible. Our team has written numerous support guides on frequently encountered problems during builds, build/deploy behaviour, drag and drop deploys, and more. In an effort to streamline your searching, we have compiled a list of our Support Guides related to builds and deploys. Each guide contains a ton of useful debugging tips that can likely help you solve your problem.

Troubleshooting and high-level debugging

Optimizing performance

Build stuck or still running

Builds Failing

Configuring Builds

If you are still having problems after reading through these guides please open a new thread and provide your site name, as much information as you can on what you have already tried, what your build settings are, your package.json, etc. Additionally, if you have an idea for a Support Guide that you don’t see above, please open a new thread and let us know! Thanks!

5 Likes
Build failed with the error - TypeError: Cannot read properties of undefined (reading 'get')
Wordpress blog not transferred properly, content pages display "page not found"
"build.command" failed. Command failed with exit code 1: parcel build index.html
Build exceeded maximum allowed runtime please help!
Building problems
Getting page not found error
Module not found: Error: Can't resolve './Components/Toolbar'
Couldn't find package
Build is empty and site says "Page Not Found"
Site cannot be accessed broken link or url that doesn't exist
"Error: No such directory" Did you forget › to run a build? after netlify deploy --prod
App responsiveness works on local but not after deploy on netlify
Localize Angular 404
Ending installation cloudcannon
"build.command" failed idk what im doing wrong here
Error in deploying my expressjs application
Deploy failed - Command failed with exit code 254
I have changed to npm run build , CI = '', CI = npm run build but the problem still persist
Netlify image issues
Deploy fail timed out
Deploy failed using parcel build
Need help Build Site error
How to deploy simple express app from Github to Netlify
Block my website from being iframe
Help in deploy process
TypeError during production
Help me about Failed during stage 'building site': Build script returned non-zero exit code: 1
I got error code 254 and I don't know how to fix it
Error Deploying a new version of my site
Deployed site gives 404
Build script returned non-zero exit code: 1 &2 - New deployments on existing site fail
Build exceeded maximum allowed runtime
Deploy issue Build command failed code 254
Command failed with exit code 254
Builds are suddenly failing with no change from me
Error: Can't resolve '/opt/build/repo/node_modules/babel-preset-react-app/node_modules/@babel/runtime/helpers/esm/slicedToArray.js' in '/opt/build/repo/src/components'
"non-zero exit code: 2"
My page is deployed on Netlify, but selecting another page gets Page not found
Netlify deployment not working giving this error regarding dependencies , I have used Material UI and React Js for this project
Build Error: ENOTFOUND artifcatory-slc.oraclecorp.com
Gatsby 4 Build Issue Works Local but Fails on Netlify
I have problem in my nft minying website can help me?
404 for my site
Nuxt build hangs during the generation
Build not create in netlify
Issue Deploying Remix in NX monorepo - Page not found
Getting "Failed during stage 'building site': Build script returned non-zero exit code: 1" - works with netlify dev locally
Nft minting website build commads error I'm getting an error like this can anyone help?
[Support Guide] Compiled CDN Resources — start here!
How to use python 3.10
Command failed with exit code 254: CI= npm run build (https://ntl.fyi/exit-code-254)
Hosting reveal.js presentation on netlify via gitlab private repo - 404 Page not found error
I am getting this build error Please help
Build command failed with exit code 1 error
Deploy failed due to Errors during building
Migrating a single page JS webapp to Netlify Functions for env secret token hider
Maximum Runtime exceeds [Next.js]
Failed during stage 'Reading and parsing configuration files': When resolving config
TypeError: Cannot read properties of undefined
The site goes live but the screen is blank
Error deploying a full stack application
Pycharm projects
Old meta tags fetched by Facebook, Google, Instagram and Whatsapp on base url
"Suspected harmful website" on LinkedIn
Site won't deploy, Error checking out submodules
Error message : Command failed with exit code 255
SyntaxError: Unexpected end of JSON input","
Encounter Error Code 127 while deploying an ionic react app
Site won't reploy through GitHub repo, but I could do when I tried manually with drag and drop
Unable to access the login form/page of netlify.com, it just keeps loading
Failed during stage 'building site': Build script returned non-zero exit code: 1
Build fails because it can't resolve an image that is there?
Yarn install , got errors
Delpoy directory build does not exist , Tailwind Css
Netlify can not find updload folder in the root directory
Error when deploying to Netlify DNS via Netlify API
React App not showing on mobile
Error Deploying Angular App
Site does not update after file updates from Gitlab
Unable to Deploy A NextJS Application
Wordpress Static Export (Simply Static/WP2Static) Not Displaying Properly When Uploaded to Netlify
Deployment Error - exit code 137 - Build failed due to a user error
404 not found but i'm getting successful build for my Nextjs app
React App won't deploy due to the following error: "ENOENT: no such file or directory"
Jekyll build failing - non-zero exit code: 2
React site Deployment failed
Build keeps failing, possibly because of expired payment card
Gridsome stuck on building
Deployment failure: babel command not found
Command failed with exit code 127: npm run build (https://ntl.fyi/exit-code-127)
React App Build failed
Netlify problems with production
Build exceeded memory limits
"This site can’t be reached" . why is this happening to me?
# Page Not Found
Page Not Found with Published deploy
Command failed with exit code 1: CI='' npm run build
Failed during stage 'Install dependencies': dependency_installation script returned non-zero exit code: 1
Build Failed with “non-zero exit code: 2” error
Type error: Property 'requestVideoFrameCallback' does not exist on type 'HTMLVideoElement'
Gatsby error with useRef only when deploying
Deploy failing after switching to Ubuntu Focal build image due to digital envelope routines or webpack
Netlify NextJS Build failed
Gem::Ext::BuildError: ERROR: Failed to build gem native extension
Deploy directory 'build' does not exist on Nextjs 13
Command failed with exit code 1: CI= npm run build (https://ntl.fyi/exit-code-1)
Netlify deploy with cli and give error Not found
Problem running Build command: npm run prerender
"Deploy failed due to an error in @netlify/plugin-emails plugin."
Page not found error when trying to redirect to Auth0
Context.identity null in localhost
Building site": build script returned non-zero exit code:1
Netlify build cache error
My react app won't deploy
Unable to load anything in Netlify Dashboard
Images do not present on Netlify after deploying, but they work well on the local host
I still see "Page Not Found" Even though I have an index.html file
ENOENT: no such file or directory, mkdir '/opt/build/repo/dist'
I’ve deployed my site but I see “Page not found” when going on other sites
404 Page not found after a OK deploy
My site: gracious-shannon-74dda4 is not getting deployed now, after 2 months
Node script not running after next build completes
Netlify does not let me use a certain site name that I used previously
Remix deploy successful but I get 404 error
Cannot deploy to Netlify due to build command issues
Cannot build with pnpm
Nextjs blog with headless CMS deployment problem
I have this error when deploying, please help. https://today-i-learned-23.netlify.app
Build problems: Failed to read Git log - exit code 255
Netlify it's not deploying
Page not found after deploy with html css js project
Astro framework + SSR. Netlify config headers and redirects aren't applied
Something wrong with my React app deploy
Exit code 255 Error
Failed during stage 'building site': Build script returned non-zero exit code: 2 (https://ntl.fyi/exit-code-2)
RollupError: Could not resolve "./navbars/Topbar.jsx" from "src/components/Tattoos.jsx"
Can build locally, but cannot deploy on Netlify. Lots of gyp errors
Neltify Background function is not working and not showing logs in Production
Deploying Site problem
Build failed running test coverage report
Help with API after deploying app
Failed during stage 'building site': Build script returned non-zero exit code: 2
Build error when deploying React + Vite
Failed build for a website made with react & builder.io
Website page won't show and I need help troubleshooting if possible
Some CSS styles not work on deployment
Could not resolve "./context/WishlistContext" from "src/App.jsx"
During netlify deoploy it's giving "build.command" failed error. please help
I got the error when try to deploy my nextjs application on netlify
Https://serene-sundae-24698b.netlify.app/ , https://idyllic-quokka-ec7ef9.netlify.app/,
I am getting a build error when I create a new branch and try to deploy the code in that branch
Getting 404 after successfully deploying nextJS app
When I try to build by site, it fails
My images are not showing on the website, how to fix the problem
Enqueued : awaiting capacity
Deploying Next (v13.2.4) with experimental appDir: true fails when deployed
Build Error make: *** [binding.target.mk:133: Release/obj.target/binding/src/binding.o] Error 1
React Dynamic Pages Don't Work
External links bugging
Errors: "VipsJpeg: Corrupt JPEG data: premature end of data segment" and "Input buffer contains unsupported image format"
Too many redirects error when visiting link with query parameter
[Support Guide] Using environment variables on Netlify correctly
Socket.io is not working in next js app on netlify
I cannot serve local functions in dev mode
Enqueued: Awaiting Capacity
I am having this error with my flutter webapp for some days
Gatsby Build failed due to a user error: Build script returned non-zero exit code: 2
ModuleParseError: Module parse failed: Unexpected token (10:37) You may need an appropriate loader to handle this file type
I tried to deploy react based web app but i got this errors
Deployment not reaching internet
Build and Deploy netlify with github actions
Server crash every couple of minutes
"Failed to compile." message after 40 minutes of idle deploy
Vite edge build error ( pnpm --filter vite-edge... build )
Page not found error after successfull deployment
Next-auth middleware is throwing error on deploy
I changed my code to use process.env and the build fails (Parcel.js)
Missing Key results deployment fail
Page not found error after deploy
Npm run build error and cant resolve react-router-dom
This site can’t be reached in random manner
Deploying Payload CMS to Netlify
Netlify Identity gives 500 - Internal Server Error
Inconsistent build failures with Gatsby
Deploy not updating
Deployment not working with Mongoose and Express
Error when trying to deploy my Vuejs project
[Support Guide] Reconnecting your repository to your Netlify site
Gatsby 5 DSG function returning 404 for all pages
Deploying golang project. It's not work
Plugin "netlify-plugin-inline-critical-css" failed
Nuxt3 issue Cannot find module '/var/task/.netlify/functions-internal/server/node_modules/three/examples/jsm/loaders/GLTFLoader'
My app builds and works fine locally but not on Netlify
Tailwind Css Brooking On My Next js App
Buil command failed [Error: std::bad_alloc]
Page Not found, when I am trying to visit my hyperlinks, this is popping up
Pg gem error in gemfile while running bundle
Page not found after deploying using tailwind css
'building site': Build script returned non-zero exit code: 2
Next JS page not found after succesfull deploy
Command failed with exit code 1: npm run build
Page not found when the callback url for the authentication is called
I get this build error: Failed during stage 'building site': Build script returned non-zero exit code: 2
Deploy error: Command failed with exit code 127: CI= npm run build
Error while deploy gatsby site on netlify
Hugo based site not deploying
Problem with Netlify building
I’ve deployed my site in Vite + ReactJS but I still see “Page not found”
First time upload Deploy failed for laravel app
opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ], 1:19:00 PM: library: 'digital envelope routines', 1:19:00 PM: reason: 'unsupported', 1:19:00 PM: code: 'ERR_OSSL_EVP_UNSUPPORTED' 1:19:00 PM: }
Command failed with exit code 255: hugo --gc --minify -b $URL
Page Not Found - NuxtJS3
Edge Functions bundling failed
Deployed Slack Bolt Python backend but its return page not found? can we deploy python on Netlify and if can then how to deploy it?
Next Image stopped working
Page Not Found (index.js) runs on local development
Mehhh am confused can someone help me resolve this issues for me please
After successfully building and deploying my Angular application on Netlify, I encountered a persistent 'page not found' error
Nuxt 3 app - 404 Page not found
Initalizing failure
Netlify + Cloudflare proxy returning 521
Error while deploying netlify
I have problems using next/head with Nextjs and SSR, it seems to be an internal server problem, how do I solve it?
After installing and deinstalling astro-compress there is problem with - non-zero exit code: 1
Failed deploy using continus deployment
On deploying a new site I get page not found
Website Missing - Link Broken
Linkedin,github links and when i try to open that link on deployed portfolio it showing an error that "page not found"
Help me with my 404 code
Could not load edge function at '/opt/build/repo/.netlify/edge-functions/angular-ssr/angular-ssr.mjs'
Netlify release redirects to 404
Can't Deploy to code sandbox through netlify
Issue im having with NPM
Https://app.netlify.com/teams/myteam/builds/620a2e4712a5ff0008b18311
Command failed with exit code 127: nmp run build
Angular i18n redirects 404
Blank page showing up for Next.js deployment
Error Command "build" not found
Deployment failing due to webpack-cli issue
Problems with deploy
Getting Error deploying site on netlify
Production Build [rollup-plugin-dynamic-import-variables] Unexpected token
Problems with deployment - autoprefixer
Angular Universal Plugin Error
Digital asset links file not accessible because it's in a dot (.) folder
Failed Log (Academic Starter in R)
Cryptic relative import error when loading edge functions on Netlify CLI
Command failed with exit code 137: yarn build (https://ntl.fyi/exit-code-137)
Issue building website from plasmic.app to netlify
Deploy details Deploy failed
Help with Deploying Specific Commits on Netlify
Manual deploy - stuck at uploading
My deployed site still show "page not found" ;(
pageContext array is accessible locally but not work on built
Build timeout and node settings
Facing Origin Error in my Site
Build script: non-zero exit code: 127
Dependencies installation error
Netlify deploy fails at build phase. Please help deploy my site
Deployment error build.command failed

I am having problem in trig erring this site of mine.
Site name:
gracious-shannon-74dda4

Please click below both URLs for a clear preview:

Waiting for the reply.

:wave: @Sumair1981 , the error says you’ll need to update your build image. Please give that a try and let us know if you run into any trouble! Netlify App

Thanks for your response,
I switched my site’s image to: Ubuntu Focal 20.04 (default) then it deployed and updated my site successfully.
Thanks & Regards.

2 Likes

it didn’t work for me

1 Like

We will need more information to assist you.