Sharp Missing In Production
Why This Error Occurred
The next/image component's default loader uses squoosh because it is quick to install and suitable for a development environment.
- For a production environment using
next start, it is strongly recommended you installsharp.
You are seeing this error because Image Optimization in production mode (next start) was detected.
- For a production environment using
output: "standalone", you must installsharp.
You are seeing this error because Image Optimization in standalone mode (output: "standalone") was detected.
Possible Ways to Fix It
- Install
sharpby running one of the following commands in your project directory:
Terminal
npm i sharpTerminal
yarn add sharpTerminal
pnpm add sharpTerminal
bun add sharpThen, build your project with next build. Finally, restart the server with either next start for production mode or node .next/standalone/server.js for standalone mode.
- If
sharpis already installed but can't be resolved, set theNEXT_SHARP_PATHenvironment variable such asexport NEXT_SHARP_PATH=/tmp/node_modules/sharp. Then, build your project withnext build. Finally, restart the server with eithernext startfor production mode ornode .next/standalone/server.jsfor standalone mode.
Note: This is not necessary for Vercel deployments, since
sharpis installed automatically for you.
Useful Links
Was this helpful?