Set up an SMTP email provider

Set up an email provider to get SMTP credentials. We recommend Ethereal Mail for local development/testing and Resend, SendGrid or AWS SES for production.

Your email provider should let you configure the email domain that invite and alert notifications will use as the "from" address and give you the other SMTP credentials needed for the following steps.

If you do not provide an email domain, by default, Measure will use the SITE_ORIGIN varaiable where the dashboard is deployed as the "from" address.

Configure SMTP email settings for existing users

If you are upgrading from v0.7.x, you would need to manually configure the SMTP settings.

1. Edit the self-host/.env file.

2. Add the following environment variables as obtained from your email provider.

   SMTP_HOST=smtp.yourprovider.email   # change this
   SMTP_PORT=587                       # change this
   SMTP_USER=user@yourprovider.email   # change this
   SMTP_PASSWORD=some_secret_password  # change this
   EMAIL_DOMAIN=your_email_domain.com  # change this

3. Run the following command to shutdown all services.

   sudo docker compose \
     -f compose.yml \
     -f compose.prod.yml \
     --profile migrate \
     down

4. Finally, run the install.sh script for the configuration to take effect.

   sudo ./install.sh