Skip to content
Invitation-only alpha. Features and limits may change as we learn from testing.

Supabase Auth over SMTP

Supabase Auth, also known as GoTrue, sends sign-up confirmations, magic links and password resets over SMTP. You can point it at weneed.email.

  • An SMTP credential for the address Supabase should send from.
  • Its password, which was shown once when you created it.

The dashboard shows these values, filled in, on the credential’s View SMTP settings page.

For self-hosted GoTrue:

Terminal window
GOTRUE_SMTP_HOST=smtp.weneed.email
GOTRUE_SMTP_PORT=587
GOTRUE_SMTP_USER=smtp_… # your credential's username
GOTRUE_SMTP_PASS=… # from your secret store
GOTRUE_SMTP_ADMIN_EMAIL=hello@yourdomain.com # exactly the credential's sender
GOTRUE_SMTP_SENDER_NAME=Your App

On Supabase’s hosted platform, enter the same host, port, username, password and sender address in the project’s custom SMTP settings.

Check the variable names against your GoTrue version.

  • The sender must match exactly. Any other From address is refused.
  • Duplicates are possible. GoTrue can’t add an idempotency header. If a connection drops after weneed.email stored a message but before GoTrue saw the reply, GoTrue may send it again and the user gets two emails. See Retries and duplicates.
  • Watch your allowance. Every sign-up and reset counts. See Alpha allowance.