diff --git a/content/docs/database.md b/content/docs/database.md
index 21bfa36..c80b450 100644
--- a/content/docs/database.md
+++ b/content/docs/database.md
@@ -24,6 +24,8 @@ You can maintain configuration files such as `.env` directly in your repository.
 You can reference them via placeholders such as `DB_PASSWORD={{ .runtime.db.password }}` and we will automatically inject the correct values during the deployment. 
 We support you with this during the project setup. A complete guide can be found under [runtime configuration](https://docs.ionos.space/docs/runtime-configuration/).
 
+If you encounter problems with your database connection, we recommend always URL-encoding the database password using ${IONOS_DB_PASSWORD.urlEncoded()} in your environment template and disabling any additional URL encoding performed by the framework configuration to avoid double-encoding errors.
+
 ## Access
 
 You can access the databases via phpMyAdmin right from your Deploy Now dashboard. Databases are not publicly accessible.