Step 1: Authorize the Alias in Gmail 

You must tell Google that you own the other email address before it will allow OpenProject to send as that address.

  1. Log into your Gmail account and click the gear icon for Settings > See all settings.
  2. Go to the Accounts and Import tab.
  3. In the “Send mail as” section, click Add another email address.
  4. Enter the Name you want users to see and the Alias email address.
  5. Keep “Treat as an alias” checked and click Next Step.
  6. Follow the prompts to send and verify the confirmation code sent to that alias.

Step 2: Configure OpenProject Settings 

Once the alias is verified in Gmail,
update your OpenProject Administration -> Emails and notification settings: 

  • Emission email address: Enter your Alias email address (the one you just verified).
  • SMTP serversmtp.gmail.com.
  • SMTP port587.
  • SMTP HELO domaingmail.com (or your custom domain).
  • SMTP authenticationlogin.
  • SMTP username: Your Primary Gmail address.
  • SMTP password: Your Gmail App Password (do not use your regular account password).

Troubleshooting

  • Security Hurdles:
    If you have 2-Step Verification enabled,
    you must generate and use a 16-character App Password 
    rather than your standard Gmail password.
  • Environment Variables:
    If you are using Docker or a package installation,
    setting environment variables like EMAIL_DELIVERY_METHOD="smtp" or SMTP_USER_NAME may disable the UI settings.
    In this case,
    ensure you also set OPENPROJECT_EMAILS__NO__REPLY__ADDRESS to your desired alias

Leave a Reply