Can somebody please clarify how SMTP settings work?

[ovizii]

I asked around and was told I can use docker variables so I have these inside my .env file:

SMTP_ADDRESS=10.10.10.10
SMTP_PORT=25
#SMTP_DOMAIN=
#SMTP_USERNAME=
#SMTP_PASSWORD=
SMTP_AUTHENTICATION=none
SMTP_ENABLE_STARTTLS_AUTO=false
SMTP_FROM=me@mydomain.tld

and these inside my docker-compose.yml file within the docuseal app:

    environment:
      SMTP_ADDRESS: ${SMTP_ADDRESS}
      SMTP_PORT: ${SMTP_PORT}
#      SMTP_DOMAIN: ${SMTP_DOMAIN}
#      SMTP_USERNAME: ${SMTP_USERNAME}
#      SMTP_PASSWORD: ${SMTP_PASSWORD}
      SMTP_AUTHENTICATION: ${SMTP_AUTHENTICATION}
      SMTP_ENABLE_STARTTLS_AUTO: ${SMTP_ENABLE_STARTTLS_AUTO}
      SMTP_FROM: ${SMTP_FROM}

I can test these settings are working by pretending I forgot my email and docuseal will send me a password reset link.
Also, I had to comment those 3 lines as leaving them uncommented won't work.

What I still do not get is how to add/invite other people to collaborate. Within docuseal I see this warning whenever I try to do so:

The link: "Go to SMTP settings" leads here and gives this error when I leave the username field empty

Could somebody please help me figure this out? Are SMTP settings via -env only used for the system messages and each user needs to define his own SMTP settings? Why is it still asking for username despite: #23

[AlexBTurchyn]

@ovizii You configure SMTP only once for the entire project. You can use an email address as a username. If you are not familiar with the SMTP configuration process, here is the documentation for GMAIL as an example

[ovizii]

Thanks for your reply but I have to ask again:

When you say you configure it once, where do I do that? In the .env file like I did which works for the lost password reset emails OR via the GUI as can be seen in my last screenshot above? I assume if I remove the SMTP config from my .env file the lost password emails will no longer work?

I do know enough to configure SMTP, I run a local postfix server which only accepts emails from a few of my docker container and relays them through different SMTP servers one of them being Gmail. It depends on which container is sending the emails. This postfix works just fine but as it is only used for this job, I have not added authentication to it. So I need to specify the postfix IP, port 25 and it will accept the email but as you can see above, docuseal's GUI keeps asking me to input a username.

I just saw last night's update and there are more options now but still no "authentication: none" available :-(

[ovizii]

And yet, despite only having SMTP details inside .env I was able to submit a document and get a notification via email, even though I have not configured SMTP settings via the GUI.

[AlexBTurchyn]

@ovizii A fix has been added in the latest release (1.1.3) that enables email sending when SMTP is configured using environment variables. Let me know if these improvements work for you.

[ovizii]

Thanks, that worked perfectly. My instance is now using the SMTP settings configured via env variables.

One last thing to add is that it would be even more amazing if the GUI SMTP settings also had the option of “authentication: none” and not make the username and password fields mandatory in case someone prefers to use the GUI for configuring the SMTP settings.

Current options: