Astral
/ Pixi

Gmail SMTP Setup

Configure Gmail as your SMTP provider for sending emails from Pixi.

Get App Password from Google

Gmail requires an app-specific password for SMTP authentication.

Enable 2-Step Verification

  1. Go to Google Account Security
  2. Click 2-Step Verification (use search if needed)
  3. Enable and add any second step authentication method

Generate App Password

  1. In 2-Step Verification settings, find App passwords
  2. Click to open App passwords page
  3. Enter app name: "Pixi"
  4. Click Create
  5. Copy the 16-character password

::hint[style=info] Can't find App passwords? Use the search bar in Google Account settings. ::

Configure SMTP in Pixi

Enter these settings in Pixi's SMTP configuration:

  • Host: smtp.gmail.com
  • Port: 465
  • Username: Your full Gmail address
  • Password: The 16-character app password from above
  • From Email: Same as username or an alias configured in Gmail

Test Connection

Click Test SMTP to verify your settings. You should receive a test email confirming the configuration works.

Troubleshooting

  • Authentication failed: Verify 2-Step Verification is enabled
  • Invalid credentials: Ensure you're using the app password, not your Gmail password
  • Connection timeout: Check if port 465 is blocked by your firewall

Next Steps