MeshCentral Email Configuration

Gmail Setup (Recommended for Testing)

1. Enable 2-Factor Authentication on your Gmail account
   • Go to https://myaccount.google.com/security
   • Enable 2-Step Verification
2. Create App-Specific Password
   • Go to https://myaccount.google.com/apppasswords
   • Select "Mail" and "Other (Custom name)"
   • Name it "MeshCentral"
   • Copy the 16-character password
3. Update Environment Variables in DigitalOcean

   # Update the app with your email credentials
   SMTP_USER=your-email@gmail.com
   SMTP_PASSWORD=your-16-char-app-password

4. Update via doctl (or manually in DO console)

   doctl apps update 0ceb0932-3fa7-4a42-9a51-f0a124360a04 --spec .do-app-spec.yaml

Alternative Email Services

SendGrid (Recommended for Production)

• SMTP_HOST: smtp.sendgrid.net
• SMTP_PORT: 587
• SMTP_USER: apikey
• SMTP_PASSWORD: Your SendGrid API Key
• Free tier: 100 emails/day

Mailgun

• SMTP_HOST: smtp.mailgun.org
• SMTP_PORT: 587
• SMTP_USER: Your Mailgun SMTP username
• SMTP_PASSWORD: Your Mailgun SMTP password
• Free tier: 5,000 emails/month for 3 months

Microsoft 365/Outlook

• SMTP_HOST: smtp-mail.outlook.com
• SMTP_PORT: 587
• SMTP_USER: your-.nosp@m.emai.nosp@m.l@out.nosp@m.look.nosp@m..com
• SMTP_PASSWORD: Your password or app password

Testing Email

After configuration:

1. Create a new account with a real email address
2. Check your inbox (and spam/junk folder)
3. Click the verification link

Troubleshooting

• Emails not sending: Check SMTP credentials are correct
• Emails in spam: Configure SPF/DKIM records for your domain
• Gmail blocking: Make sure you're using an app-specific password, not your regular password
• Connection refused: Verify SMTP_HOST and SMTP_PORT are correct
• Authentication failed: Double-check SMTP_USER and SMTP_PASSWORD

Current Configuration

• SMTP Host: smtp.gmail.com
• SMTP Port: 587 (TLS)
• From Address: norep.nosp@m.ly@e.nosp@m.veryd.nosp@m.ayte.nosp@m.ch.au
• New Accounts: Enabled
• Email Verification: Required (userNameIsEmail=true)