diff --git a/README.md b/README.md
index 9ceb4cc74ea7f9a61d365dda64e6fdbae1089c69..798956fd5326f474ace3464489677bb2ec34c0c3 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,10 @@ file in the following places in the following order:
 
 The first located file is used.
 
+> **Note:** The `crypt` python library behaves differently on MacOS than Linux
+> and fails to create acceptable passwords for new Google accounts.
+> Build the docker image and run gsuitesync via it to overcome this.
+
 ## Installation
 
 The command-line tool can be installed directly from the git repository: