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.
- Log into your Gmail account and click the gear icon for Settings > See all settings.
- Go to the Accounts and Import tab.
- In the “Send mail as” section, click Add another email address.
- Enter the Name you want users to see and the Alias email address.
- Keep “Treat as an alias” checked and click Next Step.
- 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 server:
smtp.gmail.com. - SMTP port:
587. - SMTP HELO domain:
gmail.com(or your custom domain). - SMTP authentication:
login. - 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 likeEMAIL_DELIVERY_METHOD="smtp"orSMTP_USER_NAMEmay disable the UI settings.
In this case,
ensure you also setOPENPROJECT_EMAILS__NO__REPLY__ADDRESSto your desired alias
