diff --git a/doc/configuration-password-management.xml b/doc/configuration-password-management.xml
index 4a6a2c0b..2a535996 100644
--- a/doc/configuration-password-management.xml
+++ b/doc/configuration-password-management.xml
@@ -129,6 +129,18 @@ node3:5432:repmgr:repmgr:foo
 node3:5432:replication:repluser:foo</programlisting>
 
     </para>
+    <note>
+      <para>
+        It's possible to specify an alternative location for the <filename>~/.pgpass</filename> file, either via
+        the environment variable <envar>PGPASSFILE</envar>, or (from PostgreSQL 9.6) using the
+        <varname>passfile</varname> parameter in connection strings.
+      </para>
+      <para>
+        If using the <varname>passfile</varname> parameter, it's essential to ensure the file is in the same
+        location on all nodes, as when connecting to a remote node, the file referenced is the one on the
+        local node.
+      </para>
+    </note>
 
   </sect2>