2023-07-05 15:11:16 +02:00
---
title: 'Install `sharp` to Use Built-In Image Optimization'
---
2020-10-16 13:10:01 +02:00
2023-07-05 15:11:16 +02:00
## Why This Error Occurred
2020-10-16 13:10:01 +02:00
2023-07-05 15:11:16 +02:00
Using Next.js' built-in [Image Optimization](/docs/pages/building-your-application/optimizing/images) requires [sharp](https://www.npmjs.com/package/sharp) as a dependency.
2020-10-21 12:21:42 +02:00
2020-10-30 15:56:11 +01:00
You are seeing this error because your OS was unable to [install sharp](https://sharp.pixelplumbing.com/install) properly, either using pre-built binaries or building from source.
2020-10-16 13:10:01 +02:00
2023-07-05 15:11:16 +02:00
## Possible Ways to Fix It
2020-10-16 13:10:01 +02:00
2020-10-30 15:56:11 +01:00
Option 1: Use a different version of Node.js and try to install `sharp` again.
2020-10-16 13:10:01 +02:00
2023-07-05 15:11:16 +02:00
```bash filename="Terminal"
2020-10-16 13:10:01 +02:00
npm i sharp
2023-07-25 00:33:12 +02:00
```
```bash filename="Terminal"
2020-10-16 13:10:01 +02:00
yarn add sharp
```
2020-10-21 12:21:42 +02:00
2023-07-25 00:33:12 +02:00
```bash filename="Terminal"
pnpm add sharp
```
2023-08-11 01:44:20 +02:00
```bash filename="Terminal"
bun add sharp
```
2024-05-21 17:42:55 +02:00
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.
2020-10-21 12:21:42 +02:00
2020-10-30 15:56:11 +01:00
For example, see [macOS Catalina instructions](https://github.com/nodejs/node-gyp/blob/66c0f0446749caa591ad841cd029b6d5b5c8da42/macOS_Catalina.md).
2024-05-21 17:42:55 +02:00
Option 4: Use a different OS and try to install `sharp` again.
2020-10-30 15:56:11 +01:00
For example, if you're using Windows, try using [WSL](https://docs.microsoft.com/en-us/windows/wsl/about) (Windows Subsystem for Linux).