X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/b20a534e0c253e9371377efe75b4682b5070ffa3..d4b633bfc50188f36e3c4a8b2b99c3a0e6a7f12e:/docs/admin/Migration.md

diff --git a/docs/admin/Migration.md b/docs/admin/Migration.md
index 94f403ec..6ae7a927 100644
--- a/docs/admin/Migration.md
+++ b/docs/admin/Migration.md
@@ -9,6 +9,18 @@ SQL statements should be executed from the postgres commandline. Execute
 
 ## 3.2.0 -> master
 
+### New database connection string (DSN) format
+
+Previously database connection setting (`CONST_Database_DSN` in `settings/*.php`) had the format
+
+   * (simple) `pgsql://@/nominatim`
+   * (complex) `pgsql://johndoe:secret@machine1.domain.com:1234/db1`
+
+The new format is
+
+   * (simple) `pgsql:dbname=nominatim`
+   * (complex) `pgsql:dbname=db1;host=machine1.domain.com;port=1234;user=johndoe;password=secret`
+
 ### Natural Earth country boundaries no longer needed as fallback
 
 ```