Skip to content
DocsErrorsInstall `sharp` to Use Built-In Image Optimization

Install `sharp` to Use Built-In Image Optimization

Why This Error Occurred

Using Next.js' built-in Image Optimization requires sharp as a dependency.

You are seeing this error because your OS was unable to install sharp properly, either using pre-built binaries or building from source.

Possible Ways to Fix It

Option 1: Use a different version of Node.js and try to install sharp again.

Terminal
npm i sharp
Terminal
yarn add sharp
Terminal
pnpm add sharp
Terminal
bun add sharp

Option 2: Try installing the wasm variant of sharp by running npm install --cpu=wasm32 sharp.

Option 3: If using macOS, ensure XCode Build Tools are installed and try to install sharp again.

For example, see macOS Catalina instructions.

Option 4: Use a different OS and try to install sharp again.

For example, if you're using Windows, try using WSL (Windows Subsystem for Linux).