Skip to main content

Configure a Gmail account as SMTP server to send emails


This is a community-contributed guide. This guide is based on certain Obico community members' own setup and hence may not work for you.

To use Gmail's SMTP server for sending email, follow the following simple steps.

1. Make sure the 2-Step Verification is turned on for the Gmail account.

Follow this guide to turn on 2-Step Verification.

2. Add an "app password" for your self-hosted Obico server.

  1. Go to the account page for the Gmail account you intend to use.
  2. Select "Security".
  3. Under "How you sign in to Google" select "2-Step Verification".
  4. At the bottom, choose "App Passwords".
  5. Choose a name for this app password, such as "My Obico server".
  6. Click "Create".
  7. On the next screen, copy the text in the white box. This is the pass you will use in the next step.

Site configuration

Site configuration

Site configuration

Site configuration

If you run into issues creating an app password, you can check out Google's guide.

3. Configure .env with the correct email settings.

If you can't find the .env file, check out this guide.

4. Restart the server.

docker compose up --build -d

5. Send a test email

Follow this guide to send a test email.