From ab95183e4fb9f2f4ed4dfa1a477ef2028ca3a090 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=A0imon=20Brandner?= Date: Mon, 23 Nov 2020 08:45:21 +0100 Subject: [PATCH 1/3] Added inotify instance limit info --- README.md | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index c54eac9dc5..5cad146f57 100644 --- a/README.md +++ b/README.md @@ -275,22 +275,29 @@ modifying it. See the [configuration docs](docs/config.md) for details. Open http://127.0.0.1:8080/ in your browser to see your newly built Element. **Note**: The build script uses inotify by default on Linux to monitor directories -for changes. If the inotify watch limit is too low your build will silently fail. -To avoid this issue, we recommend a limit of at least 128M. +for changes. If the inotify limits are too low your build will fail silently or with +`Error: EMFILE: too many open files`. To avoid these issues, we recommend a watch limit +of at least `128M` and instance limit around `512`. -To set a new inotify watch limit, execute: +Linked issues are [#15750](https://github.com/vector-im/element-web/issues/15750) and +[#15774](https://github.com/vector-im/element-web/issues/15774). + +To set a new inotify watch and instance limit, execute: ``` -$ sudo sysctl fs.inotify.max_user_watches=131072 -$ sudo sysctl -p +sudo sysctl fs.inotify.max_user_watches=131072 +sudo sysctl fs.inotify.max_user_instances=512 +sudo sysctl -p ``` -If you wish, you can make this new limit permanent, by executing: +If you wish, you can make the new limits permanent, by executing: ``` -$ echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf -$ sudo sysctl -p +echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf +echo fs.inotify.max_user_instances=512 | sudo tee -a /etc/sysctl.conf +sudo sysctl -p ``` + ___ When you make changes to `matrix-react-sdk` or `matrix-js-sdk` they should be From 80e5c220658c1ae6680d5f94cda4960998b6ad61 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=A0imon=20Brandner?= Date: Mon, 23 Nov 2020 18:35:29 +0100 Subject: [PATCH 2/3] Better wording Co-authored-by: J. Ryan Stinnett --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5cad146f57..a74c8fbbf2 100644 --- a/README.md +++ b/README.md @@ -279,8 +279,8 @@ for changes. If the inotify limits are too low your build will fail silently or `Error: EMFILE: too many open files`. To avoid these issues, we recommend a watch limit of at least `128M` and instance limit around `512`. -Linked issues are [#15750](https://github.com/vector-im/element-web/issues/15750) and -[#15774](https://github.com/vector-im/element-web/issues/15774). +You may be interested in issues [#15750](https://github.com/vector-im/element-web/issues/15750) and +[#15774](https://github.com/vector-im/element-web/issues/15774) for further details. To set a new inotify watch and instance limit, execute: From 4c1752e18cd1b6eba0cd385153897865122efbc4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=A0imon=20Brandner?= Date: Mon, 23 Nov 2020 18:36:20 +0100 Subject: [PATCH 3/3] Cleanup Co-authored-by: J. Ryan Stinnett --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a74c8fbbf2..936154d06a 100644 --- a/README.md +++ b/README.md @@ -293,7 +293,7 @@ sudo sysctl -p If you wish, you can make the new limits permanent, by executing: ``` -echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf +echo fs.inotify.max_user_watches=131072 | sudo tee -a /etc/sysctl.conf echo fs.inotify.max_user_instances=512 | sudo tee -a /etc/sysctl.conf sudo sysctl -p ```