docs: add a note to set container nofile ulimit for Fedora users (#14092)
Fixes https://github.com/netdata/netdata/issues/14062
Ilya Mashchenko committed
Dec 6, 2022 at 17:33 UTC
6f2f84936b70503b8b8effa271e2a5ecaa11dce3
1 file changed
+27
packaging/docker/README.md
+27
@@ -37,6 +37,33 @@ and unfortunately not something we can realistically work around.
37
38
## Create a new Netdata Agent container
39
40
+<details>
41
+<summary>Prerequisite steps for Fedora users</summary>
42
+
43
+There is a known issue with [Docker Engine on Fedora](https://docs.docker.com/engine/install/fedora/) where a task
44
+running in a container hangs and consumes 100% of the CPU core. The issue is not Netdata specific. When setting
45
+the `nofile` ulimit, the task performs normally.
46
+
47
+To fix the issue, add the following to the `/etc/docker/daemon.json` file and restart `docker.service`:
48
+
49
+```json
50
+{
51
+ "default-ulimits": {
52
+ "nofile": {
53
+ "Hard": 4096,
54
+ "Name": "nofile",
55
+ "Soft": 4096
56
+ }
57
+ }
58
+}
59
+```
60
+
61
+An alternative solution is to set ulimit `nofile` when creating a Netdata container
62
+with [docker run](https://docs.docker.com/engine/reference/commandline/run/#set-ulimits-in-container---ulimit)
63
+or [docker-compose](https://docs.docker.com/compose/compose-file/compose-file-v3/#ulimits).
64
+
65
+</details>
66
+
67
You can create a new Agent container using either `docker run` or Docker Compose. After using either method, you can
68
visit the Agent dashboard `http://NODE:19999`.
69