Documentation
User & admin guide
Back to Calendar
Admin guide

SMTP email

Configure SMTP as an alternative to Azure AD for sending magic-link login emails.

herbe.calendar can send magic-link login emails via SMTP instead of (or alongside) Microsoft Graph. Use SMTP if your organization doesn't use Microsoft 365, or if you want to decouple email sending from your Azure AD configuration.

Configure at Admin → Config → SMTP Email.

Fields

FieldNotes
HostSMTP server hostname, e.g. smtp.gmail.com or your on-prem relay
Port587 for STARTTLS, 465 for TLS/SSL
UsernameSMTP login — usually your email address
PasswordSMTP password or app-specific password
Sender emailThe "from" address on login emails
Sender nameDisplay name (defaults to "herbe.calendar")

Click Save SMTP, then Test SMTP. A test email is sent to your own address. If it arrives, the configuration is working.

Gmail

Gmail requires an app-specific password when 2-step verification is enabled:

  1. Go to your Google Account → Security → enable 2-Step Verification if not already on.
  2. Go to myaccount.google.com/apppasswords.
  3. Create a new app password for "herbe.calendar".
  4. Use smtp.gmail.com, port 587, your Gmail address as username, and the generated app password.

Running SMTP alongside Azure AD

If you have Azure AD configured for calendar sync and user listing but want to use a different mailbox for login emails, enable SMTP. herbe.calendar uses SMTP for transactional email and Azure for calendar data when both are configured. The SMTP sender email takes precedence for login emails when SMTP is active.