Prepare your Gmail account

  1. Sign in to the correct Google Account and turn on 2-Step Verification.
  2. Open Google App Passwords, name the credential AeroMailer, generate it, and copy it. Use it instead of your ordinary Google password. AeroMailer does not provide Google OAuth sign-in in this release.
  3. Personal Gmail has IMAP on; there is no Enable IMAP switch to look for. For Google Workspace, ask the administrator whether IMAP and app-password access are allowed. If your account requires OAuth or does not offer app passwords, do not bypass policy; use a compatible client or an approved sending option.
AeroMailer interface: Set up Gmail IMAP and SMTP with a Google App Password
Sample-data app screenshot. Select the image to view it at full size; your accounts and content will differ.

Enter Gmail’s servers

  1. Go to Workspace → Accounts → Add Account and select Google / Gmail.
  2. Sending: smtp.gmail.com, 587 with STARTTLS or 465 with SSL/TLS. Use your full email address, app password and an authorized From address.
  3. Receiving: imap.gmail.com, 993, TLS/SSL, with your full address and the permitted app password. Keep the mailbox as INBOX unless you intentionally want another folder.
  4. Use Test Connection, then Create account. No verification code is required, and the connection test sends no email. To test delivery, send to a mailbox you control and verify the reply.

If Gmail refuses to sign in

Check the account, port, encryption, and credential. A Google password change can revoke the app password; generate a new one and update the affected connections. Advanced Protection or administrator policy can make app passwords unavailable. Do not turn off security to work around this.

Official references: Google App Passwords, Gmail IMAP, Google SMTP, and Workspace IMAP policy.

Video walkthrough

The walkthrough covers App Passwords; the current AeroMailer form also supports receiving.