From a41a27e5c86ca4a3e182bad3e23e04ff1698164c Mon Sep 17 00:00:00 2001 From: James Manes <7748434+jamesmanes@users.noreply.github.com> Date: Sat, 30 Nov 2024 23:12:48 -0600 Subject: [PATCH 1/2] Added information about using percent encoding for SMTP username:password fields. --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 48cceb6..4d5ea8d 100644 --- a/README.md +++ b/README.md @@ -214,6 +214,8 @@ PDS_EMAIL_SMTP_URL=smtps://resend:@smtp.resend.com:465/ PDS_EMAIL_FROM_ADDRESS=admin@your.domain ``` +If the username and/or password contain special characters, the special characters will need to be [percent encoded](https://en.wikipedia.org/wiki/Percent-encoding). For example, `user&name:p@ssword` would become `user%26name:p%40ssword`. + _Note: Your PDS will need to be restarted with those variables. This varies depending on your setup. If you followed this installation guide, run `systemctl restart pds`. You might need to restart the server or recreate the container, depending on what you are using._ ### Updating your PDS -- 2.51.2 From e0a579f759dba6f180d301e4c996f4960ddebf37 Mon Sep 17 00:00:00 2001 From: James Manes <7748434+jamesmanes@users.noreply.github.com> Date: Mon, 2 Dec 2024 15:05:08 -0600 Subject: [PATCH 2/2] Added more info for percent encoding. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4d5ea8d..7ca7067 100644 --- a/README.md +++ b/README.md @@ -214,7 +214,7 @@ PDS_EMAIL_SMTP_URL=smtps://resend:@smtp.resend.com:465/ PDS_EMAIL_FROM_ADDRESS=admin@your.domain ``` -If the username and/or password contain special characters, the special characters will need to be [percent encoded](https://en.wikipedia.org/wiki/Percent-encoding). For example, `user&name:p@ssword` would become `user%26name:p%40ssword`. +If the username and/or password contain special characters, the special characters will need to be [percent encoded](https://en.wikipedia.org/wiki/Percent-encoding). For some email services, the username will contain an extra `@` symbol that will also need to be percent encoded. For example, the URL `user&name@oci:p@ssword@smtphost:465` after percent encoding for the username and password fields would become `user%26name%40oci:p%40ssword@smtphost:465`. _Note: Your PDS will need to be restarted with those variables. This varies depending on your setup. If you followed this installation guide, run `systemctl restart pds`. You might need to restart the server or recreate the container, depending on what you are using._ -- 2.51.2