diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index baf0add46e0..9b60358feb9 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -1591,12 +1591,15 @@ StateDirectory=aaa/bbb ccc
i.e. writable mounts appearing on the host will be writable in the unit's namespace too, even when propagated
below a path marked with ReadOnlyPaths=! Restricting access with these options hence does
not extend to submounts of a directory that are created later on. This means the lock-down offered by that
- setting is not complete, and does not offer full protection.
+ setting is not complete, and does not offer full protection.
Note that the effect of these settings may be undone by privileged processes. In order to set up an
effective sandboxed environment for a unit it is thus recommended to combine these settings with either
- CapabilityBoundingSet=~CAP_SYS_ADMIN or
- SystemCallFilter=~@mount.
+ CapabilityBoundingSet=~CAP_SYS_ADMIN or SystemCallFilter=~@mount.
+
+ Please be extra careful when applying these options to API file systems (a list of them could be
+ found in MountAPIVPS=), since they may be required for basic system functionalities.
+ Moreover, /run/ needs to be writable for setting up mount namespace and propagation.
Simple allow-list example using these directives:
[Service]