How-To Guides

How to Set Up Thunderbird Email

A complete beginner's guide to installing and configuring Mozilla Thunderbird for any email account — Gmail, Outlook, Yahoo, or your own domain. Works on Windows, Mac, Linux, and Android.

What is Thunderbird?

Mozilla Thunderbird is a free, open-source email client developed by the same organisation behind the Firefox browser. It lets you manage all your email accounts in one place — without webmail, without ads, and without your data being scanned. It works on Windows, macOS, Linux, and Android.

Step 1. Download and Install Thunderbird

1. Go to thunderbird.net and click Download.
2. Run the installer and follow the prompts. The defaults are fine for most users.
3. Launch Thunderbird when installation is complete.

Step 2. Add Your Email Account

When you first open Thunderbird, the setup wizard appears automatically. (If it doesn't, go to File → New → Existing Mail Account.)

1. Enter your name, your email address, and your password.
2. Click Continue. Thunderbird will try to detect your server settings automatically.
3. For most major providers (Gmail, Outlook, Yahoo, ProtonMail), auto-detect works perfectly. Click Done and skip to Step 5.
4. If auto-detect fails or you have a custom domain, click Configure manually and continue to Step 3.

Note for Gmail users: You'll be redirected to Google's sign-in page to authorise Thunderbird. Use an App Password if you have 2-factor authentication enabled (see Step 3a below).

Step 3. Manual Server Settings (if auto-detect fails)

If Thunderbird couldn't detect your settings automatically, you'll need to enter them yourself. Your email provider's support page should list these values — search for "your provider name IMAP SMTP settings".

Incoming (IMAP)

Server hostname

e.g. imap.gmail.com

Port

993 (SSL/TLS) or 143 (STARTTLS)

Connection security

SSL/TLS (recommended)

Authentication

Normal password

Username

Your full email address

Outgoing (SMTP)

Server hostname

e.g. smtp.gmail.com

Port

465 (SSL/TLS) or 587 (STARTTLS)

Connection security

SSL/TLS (recommended)

Authentication

Normal password

Username

Your full email address

Click Done when finished.

Step 3a. App Passwords (Gmail & Outlook with 2FA)

If you have two-factor authentication enabled on your email account (and you should!), your regular password won't work in Thunderbird. You need to generate an app password — a special password just for email apps.

Gmail

1. Go to myaccount.google.com/apppasswords
2. Select Mail as the app, and the device you're using
3. Click Generate
4. Copy the 16-character password and paste it into Thunderbird's password field

Outlook / Microsoft 365

1. Go to account.microsoft.com/security
2. Sign in → Advanced security options
3. Click Add a way to sign in or verify → App passwords
4. Generate a new password and use it in Thunderbird

You only need to do this once per device. The app password stays valid until you revoke it.

Step 4. Security Certificate Warnings

If you're connecting to a smaller or self-hosted email provider, Thunderbird may show a certificate warning. For major providers (Gmail, Outlook, Yahoo) this won't happen.

1. When the warning appears, click Advanced.
2. Review the certificate details if you wish, then click Accept the Risk and Continue.
3. You may need to do this twice — once for incoming (IMAP) and once for outgoing (SMTP).

Only accept certificates from providers you trust. If you see this warning with Gmail or Outlook, something is wrong — double-check your server settings.

Step 5. Test Your Setup

Your inbox should start downloading emails automatically. Let's send a test to make sure outgoing mail works too:

1. Click Write to compose a new message.
2. Address it to your own email address.
3. Type a quick subject and message, then click Send.
4. Click Get Messages to check for new mail.
5. If your test email arrives, everything is working!

Adding More Accounts

Thunderbird supports multiple email accounts side by side. To add another, go to File → New → Existing Mail Account and repeat the steps above. Each account gets its own inbox folder in the left sidebar.

Step 1. Install Thunderbird

1. Open the Google Play Store on your phone.
2. Search for Thunderbird and tap Install.
3. Open the app when installation finishes.

Step 2. Add Your Email Account

The first time you open Thunderbird, you'll see a welcome screen.

1. Enter your name, email address, and password.
2. Tap Continue. Thunderbird will try to detect settings automatically.
3. For Gmail, Outlook, and Yahoo, auto-detect works perfectly. Tap Allow on the sign-in page and you're done.
4. If auto-detect fails, tap Manual setup and continue to Step 3.

Gmail 2FA users: You'll need an App Password, not your regular password. See "App Passwords" below.

Step 3. Manual Setup (if auto-detect fails)

Look up your provider's IMAP and SMTP settings (search "your provider name IMAP SMTP settings"), then enter:

Incoming (IMAP)

Servere.g. imap.gmail.com

Port993

SecuritySSL/TLS

AuthenticationNormal password

UsernameYour full email address

Outgoing (SMTP)

Servere.g. smtp.gmail.com

Port465 or 587

SecuritySSL/TLS

AuthenticationNormal password

UsernameYour full email address

Tap Next then Done.

Step 4. App Passwords (if you have 2FA)

If you have two-factor authentication enabled, your regular password won't work. You need an app password instead:

Gmail

Go to myaccount.google.com/apppasswords, create a new app password for Mail, and use that 16-character code in Thunderbird.

Outlook

Go to account.microsoft.com/security → Advanced security options → App passwords → create a new one.

Step 5. Certificate Warning (custom/self-hosted only)

If you're connecting to a smaller or self-hosted provider, you may see a certificate warning. For Gmail, Outlook, Yahoo — this won't happen.

1. Tap Advanced or Continue.
2. Accept the risk. You may need to do this for both incoming and outgoing.

Only accept certificates from providers you trust.

Step 6. Test It

Your inbox should start syncing. Send yourself a test email to confirm outgoing mail works. If it arrives, you're all set!

Quick Tips

•Thunderbird checks for new mail automatically every few minutes. You can also press Get Messages to check immediately.
•You can add as many email accounts as you want — each gets its own inbox in the sidebar.
•Thunderbird also supports calendars and chat — look for the add-ons menu if you want extras.
•Back up your profile regularly — it contains all your emails, contacts, and settings. Go to Help → More Troubleshooting → Profile Directory to find it.

Visual Walkthrough

1 / 11

Need More Help?

StarCaller Academy offers 1-to-1 AI sessions and workshops that cover email, productivity tools, and much more. Book a free Discovery Call and we'll point you in the right direction.

Book a Free Call Contact Us