An adapter for the Bamboo email app.
The package can be installed as:
-
Add
bamboo_smtp
to your list of dependencies inmix.exs
:def deps do [{:bamboo_smtp, "~> 4.0.1"}] end
-
Add
:bamboo
and:bamboo_smtp
to your list of applications inmix.exs
:def application do [applications: [:bamboo, :bamboo_smtp]] end
-
Setup your SMTP configuration:
# In your config/config.exs file config :my_app, MyApp.Mailer, adapter: Bamboo.SMTPAdapter, server: "smtp.domain", hostname: "your.domain", port: 1025, username: "[email protected]", # or {:system, "SMTP_USERNAME"} password: "pa55word", # or {:system, "SMTP_PASSWORD"} tls: :if_available, # can be `:always` or `:never` allowed_tls_versions: [:"tlsv1", :"tlsv1.1", :"tlsv1.2"], # or {:system, "ALLOWED_TLS_VERSIONS"} w/ comma seprated values (e.g. "tlsv1.1,tlsv1.2") ssl: false, # can be `true` retries: 1, no_mx_lookups: false, # can be `true` auth: :if_available # can be `:always`. If your smtp relay requires authentication set it to `:always`.
Sensitive credentials should not be committed to source control and are best kept in environment variables. Using
{:system, "ENV_NAME"}
configuration is read from the named environment variable at runtime.The hostname option sets the FQDN to the header of your emails, its optional, but if you don't set it, the underlying
gen_smtp
module will use the hostname of your machine, likelocalhost
. -
Follow Bamboo Getting Started Guide
-
Optional Set
BambooSMTP.TestAdapter
as your test adapter:# In your config/config.exs file if Mix.env() == :test do config :my_app, MyApp.Mailer, adapter: MyApp.SMTPTestAdapter end
You can find more information about advanced features in the Wiki.
By participating in this project, you agree to abide by its CODE OF CONDUCT
You can see the specific CONTRIBUTING guide.
Bamboo SMTPAdapter is released under The MIT License (MIT).