From 707c9b4c543097a59cfbdcf5c069277302231f89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?M=C3=A1rcio=20Fernandes?= <marcio.fernandes@outlook.pt>
Date: Wed, 19 Aug 2026 10:57:10 +0000
Subject: [PATCH] modified:   docs/journald.md

---
 docs/journald.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/journald.md b/docs/journald.md
index b498b1f..0b63fc4 100644
--- a/docs/journald.md
+++ b/docs/journald.md
@@ -5,3 +5,27 @@
 ```bash
 journalctl -b -1 -p err
 ```
+
+## error: systemd-journald fails to start or restart
+
+*unexpected error while following the journal -24.*
+
+check current values.
+
+Example of default debian.
+
+``` bash
+cat /proc/sys/fs/inotify/max_user_instances
+90800
+128
+```
+
+Increase kernel inotify limits to values appropriate for Kubernetes nodes:
+
+```bash
+
+echo "fs.inotify.max_user_watches=1048576" | sudo tee -a /etc/sysctl.conf
+echo "fs.inotify.max_user_instances=1024" | sudo tee -a /etc/sysctl.conf
+sudo sysctl -p
+sudo systemctl restart systemd-journald
+```