diff --git a/README.md b/README.md
index 27e1e70..f4e20f7 100644
--- a/README.md
+++ b/README.md
@@ -286,7 +286,11 @@ Use the provided build script:
 - SSL/TLS setting (default: yes)
 
 **⚠️ Password Limitation:**
-The build script uses simple shell variable substitution for credentials. Passwords containing spaces, double quotes (`"`), or dollar signs (`$`) may cause the build to fail. If your password contains these characters, consider using a simpler password or manually editing the build command.
+The build script uses a heredoc approach for credentials. This works for most passwords, including those with special characters like `#` (hash). However, passwords containing **both spaces AND quotes together** (e.g., `"pass word"`) may fail.
+
+If your password contains both spaces and quotes, consider:
+- Using a simpler password
+- Manually editing the build command
 
 ---