diff --git a/src/config/Config.zig b/src/config/Config.zig
index 2cc7d52ef..fdaa1d0c4 100644
--- a/src/config/Config.zig
+++ b/src/config/Config.zig
@@ -1003,6 +1003,10 @@ keybind: Keybinds = .{},
 /// more likely to have many windows, tabs, etc. so cgroup isolation is a
 /// big benefit.
 ///
+/// This feature requires systemd. If systemd is unavailable, cgroup
+/// initialization will fail. By default, this will not prevent Ghostty
+/// from working (see linux-cgroup-hard-fail).
+///
 /// Valid values are:
 ///
 ///   * `never` - Never use cgroups.