Skip to content

Commit ad8928b

Browse files
committed
docs: Add troubleshooting on ENOSPC
Closes facebook#7612
1 parent 4bf14fa commit ad8928b

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docusaurus/docs/troubleshooting.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,24 @@ If this doesn’t happen, try one of the following workarounds:
2020

2121
If none of these solutions help please leave a comment [in this thread](https://github.com/facebook/create-react-app/issues/659).
2222

23+
## `npm start` fail due to watch error
24+
25+
If you are using Linux system and see error similar to this: `ENOSPC: System limit for number of file watchers reached`.
26+
27+
If you are running Debian, RedHat, or another similar Linux distribution, run the following in a terminal:
28+
29+
```sh
30+
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
31+
```
32+
33+
If you are running ArchLinux, run the following command instead:
34+
35+
```sh
36+
echo fs.inotify.max_user_watches=524288 | sudo tee /etc/sysctl.d/40-max-user-watches.conf && sudo sysctl --system
37+
```
38+
39+
Then paste it in your terminal and press on enter to run it. You could find more information [here](https://github.com/guard/listen/wiki/Increasing-the-amount-of-inotify-watchers#the-technical-details).
40+
2341
## `npm test` hangs or crashes on macOS Sierra
2442

2543
If you run `npm test` and the console gets stuck after printing `react-scripts test` to the console there might be a problem with your [Watchman](https://facebook.github.io/watchman/) installation as described in [facebook/create-react-app#713](https://github.com/facebook/create-react-app/issues/713).

0 commit comments

Comments
 (0)