Mozilla Thunderbird is a powerful, free, open-source email client — but setting it up manually for the first time can feel overwhelming if you’re not sure which settings to use. This complete step-by-step guide walks you through adding any email account to Thunderbird manually, including Gmail, Outlook, Yahoo, and custom business email addresses.
When Do You Need to Set Up Thunderbird Manually?
Thunderbird can often auto-configure popular email accounts like Gmail and Outlook using just your email address. Manual setup is needed when: auto-configuration fails, you have a custom business email (yourname@yourdomain.com), your server uses non-standard port numbers, your company requires specific security settings, or you need to configure POP3 instead of IMAP.
What You Need Before Starting
Gather this information from your email provider before starting: your email address and password, incoming mail server (IMAP or POP3) address and port number, outgoing mail server (SMTP) address and port number, and whether SSL/TLS or STARTTLS is required. For business email, get this from your IT department or hosting provider. For Gmail, Yahoo, and Outlook, this information is publicly documented on their support pages.
Step-by-Step: Manually Add an Email Account in Thunderbird
Step 1: Open the Account Setup Wizard
In Thunderbird, click the hamburger menu (≡) in the top-right, then go to Account Settings → Account Actions → Add Mail Account. Alternatively, from the Home screen click Set Up an Account → Email. The Account Setup dialog opens.
Step 2: Enter Your Details and Click Configure Manually
Enter your name (as it appears to recipients), your full email address, and your password. Click Continue. Thunderbird will attempt auto-configuration. If it finds settings, review them — if they look correct, you’re done. If auto-configuration fails or finds wrong settings, click Configure Manually to enter settings yourself.
Step 3: Configure Incoming Mail Server (IMAP)
For the incoming server, IMAP is strongly recommended over POP3 as it keeps emails on the server and syncs across all devices. Common IMAP settings: Gmail — imap.gmail.com, port 993, SSL/TLS. Outlook/Hotmail — outlook.office365.com, port 993, SSL/TLS. Yahoo — imap.mail.yahoo.com, port 993, SSL/TLS. Business/cPanel hosting — mail.yourdomain.com, port 993, SSL/TLS. Set Authentication to “Normal password” unless your provider requires OAuth2.
Step 4: Configure Outgoing Mail Server (SMTP)
For the outgoing server: Gmail — smtp.gmail.com, port 465 (SSL) or 587 (STARTTLS). Outlook — smtp-mail.outlook.com, port 587, STARTTLS. Yahoo — smtp.mail.yahoo.com, port 465 or 587. Business hosting — mail.yourdomain.com, port 465 (SSL) or 587 (STARTTLS). Authentication should match your incoming server settings. Your username is typically your full email address.
Step 5: Gmail-Specific — Generate an App Password
If you use Gmail with 2-Step Verification (highly recommended), you cannot use your regular Google password in Thunderbird. You need an App Password. Go to myaccount.google.com → Security → 2-Step Verification → App passwords. Select “Mail” and “Windows Computer,” then click Generate. Copy the 16-character password and use it as your Thunderbird password. Store it safely.
Step 6: Test and Finish
Click Re-test in Thunderbird to verify the settings connect successfully. If the test passes, click Done. Thunderbird will start downloading your emails. The initial sync may take a few minutes for large mailboxes. Once complete, you’ll see your folders in the left sidebar and emails in the main panel.
Troubleshooting Manual Setup Issues
- Authentication failed: Double-check your password. For Gmail/Yahoo with 2FA, use an App Password
- Connection refused: Verify server name and port number are exactly correct
- Certificate error: Ensure SSL/TLS is selected (not None) and the server name matches the certificate
- Cannot send emails: Check SMTP settings — try port 587 with STARTTLS if 465 doesn’t work
- Missing folders: Right-click your account in the sidebar → Subscribe → check the folders you want visible
Frequently Asked Questions (FAQ)
Should I use IMAP or POP3 in Thunderbird?
Use IMAP in almost all cases. IMAP keeps emails on the server and syncs across all your devices — if you delete an email in Thunderbird, it’s deleted on your phone too. POP3 downloads emails to your device and (by default) removes them from the server, meaning other devices won’t see them. Only use POP3 if you intentionally want emails stored only on one device.
Can I add multiple email accounts to Thunderbird?
Yes — Thunderbird is excellent for managing multiple email accounts. Repeat the Account Setup process for each additional account. You can set a default account for composing new emails in Account Settings → [account name] → check “Use this account when composing”. All accounts appear in the left sidebar, and you can use a unified inbox view to see all emails in one place.
Having trouble with Thunderbird manual setup? Leave a comment with your email provider and the error you’re seeing — our team will help you find the right server settings.