ContextQMD
Back to Next Js

Sharp Missing In Production

errors/sharp-missing-in-production.mdx

16.2.51.8 KB
Original Source

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 install sharp.

You are seeing this error because Image Optimization in production mode (next start) was detected.

  • For a production environment using output: "standalone", you must install sharp.

You are seeing this error because Image Optimization in standalone mode (output: "standalone") was detected.

Possible Ways to Fix It

  • Install sharp by running one of the following commands in your project directory:
bash
npm i sharp
bash
yarn add sharp
bash
pnpm add sharp
bash
bun add sharp

Then, 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 sharp is already installed but can't be resolved, set the NEXT_SHARP_PATH environment variable such as export NEXT_SHARP_PATH=/tmp/node_modules/sharp. Then, 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.

Note: This is not necessary for Vercel deployments, since sharp is installed automatically for you.