This short guides shows how to setup Plausible CE v2.1.0-rc.1 (or later) email delivery using your Gmail account.
Go to your Google security settings and create an app password to be used in Plausible CE
Update your configuration to use the Bamboo.Mua
mailer adapter. Your current SMTP_*
settings will still work.
plausible-conf.env
BASE_URL=https://plausible.example.com
SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=
+ MAILER_ADAPTER=Bamboo.Mua
+ MAILER_EMAIL=your-username-here@gmail.com
+ SMTP_HOST_ADDR=smtp.gmail.com
+ SMTP_HOST_PORT=587
+ SMTP_USER_NAME=your-username-here@gmail.com
+ SMTP_USER_PWD="wnqj fkbn jcwc byxk"
Due to the immutable nature of containers, you need to recreate plausible
to apply the new environment variables.
console
$ docker compose stop plausible
$ docker compose rm plausible
$ docker compose up -d
Now verify the updated configuration and try sending a test email.
console
$ docker compose exec plausible bin/plausible remote
iex> Application.get_env :plausible, Plausible.Mailer
#==> [
#==> adapter: Bamboo.Mua,
#==> auth: [username: "your-username-here@gmail.com", password: "wnqj fkbn jcwc byxk"],
#==> relay: "smtp.gmail.com",
#==> port: 587
#==> ]
iex> {:ok, _delivered_email} =
Plausible.Mailer.deliver_now(
Bamboo.Email.new_email(
# pick one of your own mailboxes
to: "your-username-here@gmail.com",
from: PlausibleWeb.Email.mailer_email_from(),
text_body: "test"
)
)
If it's delivered, you are all set! If not, leave the comment below and we'll try to help :)
Since this is a new SMTP client, all feedback is helpful! If it works well, please leave a thumbs up.