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 :)
@raabmar 👋
Thank you for trying it out!
Do you remember where it was located for you? I can update the guide with a note that it can be someplace else.
This guide's goal is to provide the easiest setup for self-hosters using their personal accounts so supporting Google Workspaces or other professional Google products is outside of its scope.
It should work.