
##  OS file watch limit reached
`yarn run dev`(또는 `npm run dev`) 실행 시 아래와 같은 에러가 발생하는 경우가 있습니다.
```sh
{
    "title": "OS file watch limit reached error"
}
---
$ yarn run dev
...
Caused by: - OS file watch limit reached
```
```adcard
```
### Cause
이 에러는 Linux 커널의 <mark>inotify</mark> 파일 감시 한도를 초과했을 때 발생합니다.

Next.js, Vite, Webpack 같은 개발 서버는 파일 변경을 감지하여 <mark>Hot Reload</mark>를 수행하기 위해 프로젝트 내 수많은 파일을 동시에 감시합니다.  
기본값인 `fs.inotify.max_user_watches`가 너무 낮을 경우, 감시할 파일 수가 한도를 넘어서 에러가 발생합니다.
```sh
{
    "title": "Check current inotify watch limit"
}
---
$ cat /proc/sys/fs/inotify/max_user_watches
8192
```
### Solution
`sysctl`을 사용해 `fs.inotify.max_user_watches` 값을 늘려주면 됩니다.

먼저 현재 세션에 즉시 적용합니다.
```sh
{
    "title": "Apply immediately (current session)"
}
---
$ sudo sysctl fs.inotify.max_user_watches=524288
$ sudo sysctl -p
```
재부팅 후에도 유지되도록 `/etc/sysctl.conf`에 영구 설정을 추가합니다.
```sh
{
    "title": "Persist across reboots"
}
---
$ echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
$ sudo sysctl -p
```


How to fix the 'OS file watch limit reached' error when running yarn dev by increasing the Linux inotify file watch limit

Fixing OS File Watch Limit Reached Error

OS file watch limit reached

Cause

Solution