From: Simran Singh <simsingh@redhat.com>
Date: Sat, 2 May 2026 18:52:10 +0000 (+0530)
Subject: man: EnvironmentFile= honors %h, not \$HOME
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4de3f59774b7afeaa6a70d6f072aeb5e5e1222f0;p=thirdparty%2Fsystemd.git

man: EnvironmentFile= honors %h, not \$HOME
---

diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 809cc285fdc..6524ba631a7 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -3294,6 +3294,10 @@ SystemCallErrorNumber=EPERM</programlisting>
         If the empty string is assigned to this option, the list of files to read is reset, all prior assignments
         have no effect.</para>
 
+        <para>Note that shell variables such as <literal>$HOME</literal> are not expanded in this path.
+        Use <literal>%</literal>-specifiers instead; for example, <literal>%h</literal> expands to the
+        user's home directory.</para>
+
         <para>The files listed with this directive will be read shortly before the process is executed (more
         specifically, after all processes from a previous unit state terminated. This means you can generate these
         files in one unit state, and read it with this option in the next. The files are read from the file