Start by adding the environment variables (below) to your app, and merging the
boxfile.yml
entries into your own boxfile.yml
. The script, here, is pulled
in automatically by the git.io
shortlink in the transform
hook, so you don't
need to add that.
The values of the various evars should be provided by your SMTP service provider, but here's a quick overview of the variables and what they each mean and do:
-
SMTP_USER={smtp-username}
The username provided by your SMTP provider for logging on and sending emails. Might be a full email address. -
SMTP_PASS={smtp-password}
The password used to log in to that account. -
SMTP_HOST={smtp-host}
The domain name of the SMTP server to connect to. -
SMTP_PORT={smtp-port}
The port to connect with. The official ones (which may be blocked by your cloud hosting provider, so be sure to check) are25
and587
for standard, unencrypted connections, and465
for connecting over encrypted SSL/TLS. A common nonstandard port is2525
, which acts much the same as25
and587
. One thing to note, though, is that port25
is only intended for use by email servers talking to each other, so you'll usually want587
instead. -
SMTP_TLS=starttls|ssl|tls|none
Whether to use an encrypted connection or not.none
specifies no encryption, and is strongly recommended against.ssl
andtls
both specify connecting over SSL/TLS, generally on port465
.starttls
allows the use of encryption over the non-SSL/TLS ports, by upgrading the connection after it has been established. This is generally the recommended option unless you're using port465
. -
SMTP_AUTH=login|plain
The SMTP Authentication mechanism. This is almost alwayslogin
, but some servers only supportplain
; check with your provider for which they prefer.
That should be everything.