rsnext/errors/sharp-missing-in-production.md
Steven cc1f3b8a38
Add support for AVIF to next/image (#29683)
Add support for AVIF to `next/image`

- Fixes #27882 
- Closes #27432 

## Feature

- [x] Implements an existing feature request
- [x] Related issues linked
- [x] Integration tests added
- [x] Documentation added
- [x] Update manifest output
- [x] Warn when `sharp` is outdated
- [x] Errors & Warnings have helpful link attached
- [ ] Remove `image-size` in favor of `squoosh`/`sharp` (optional, need to benchmark)
2021-10-11 23:17:47 +00:00

1.1 KiB

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 install sharp by running yarn add sharp in your project directory.

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

Possible Ways to Fix It

  • Install sharp by running yarn add sharp in your project directory and then reboot the server by running next start again
  • If sharp is already installed but can't be resolved, set the NEXT_SHARP_PATH environment variable such as NEXT_SHARP_PATH=/tmp/node_modules/sharp next start

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