diff --git a/guides/deployments/postgres.md b/guides/deployments/postgres.md
index ecea6c818..c113d7251 100644
--- a/guides/deployments/postgres.md
+++ b/guides/deployments/postgres.md
@@ -85,6 +85,8 @@ postgres:
   passwordSecret: "<your-postgres-secret-name>"
 ```
 
+> Ensure that there are no trailing white spaces in your password secret.
+
 At this point, you can install/upgrade your Coder instance using the updated
 Helm chart.
 
diff --git a/setup/installation.md b/setup/installation.md
index 6c0a3eafa..7519d66b0 100644
--- a/setup/installation.md
+++ b/setup/installation.md
@@ -114,6 +114,8 @@ kubectl config set-context --current --namespace=coder
    > other users on your system through `/proc`. If this is a concern, you can
    > use `--from-file=password=/dev/stdin` instead of `--from-literal=...` to
    > enter your password and press `Ctrl+D` when you're done to submit it.
+   >
+   > Ensure that there are no trailing white spaces in your password secret.
 
    You can find/define these values in your
    [PostgreSQL server configuration file](https://www.postgresql.org/docs/current/config-setting.html).