Import from Gmail

Importing from Gmail (or Google Workspace) requires an App Password because Google blocks standard IMAP logins for third-party apps.

Step 1: Create a Gmail App Password

1. Log in to your Google Account at myaccount.google.com.
2. Go to Security and enable 2-Step Verification if it isn't already active. (Google requires this before App Passwords are available.)
3. Search for App passwords in the search bar at the top of your Google Account settings.
4. Click App passwords and create a new one:
   • App: Mail
   • Device: Other — name it "TrekMail Import"
5. Copy the 16-character code. You will use this instead of your real Google password.

Step 2: Enable IMAP in Gmail

1. Open Gmail and go to Settings (gear icon) → See all settings.
2. Click the Forwarding and POP/IMAP tab.
3. Under IMAP access, select Enable IMAP.
4. Click Save Changes.

Step 3: Start the import in TrekMail

1. Go to Migration in the TrekMail sidebar.
2. Click the Gmail provider card. The connection settings are filled in automatically (imap.gmail.com, port 993, SSL).
3. Email address: Enter your full Gmail address (you@gmail.com).
4. Password: Paste the 16-character App Password from Step 1. Do not use your regular Google password.
5. Click Check connection to verify and load your folders.
6. In Step 2, select the folders you want to import and set any options.
7. In Step 3, choose your destination TrekMail mailbox and click Start import.

Common mistakes

• "Authentication failed / invalid credentials" — Google no longer accepts regular account passwords for IMAP access. This applies to all Gmail and Google Workspace accounts — even when the password is correct. You must use an App Password (Step 1 above).
• "App passwords not available" — 2-Step Verification must be enabled on the account first. Go to myaccount.google.com/security and enable it, then return to create the App Password.
• "IMAP disabled" — IMAP is off by default in Gmail. Complete Step 2 above.
• Google Workspace admins: Each user must enable 2-Step Verification on their own Google account before an App Password becomes available to them. You can enforce this in the Workspace Admin Console under Security → Authentication → 2-Step Verification.

Migrating many Gmail accounts?

Use the Bulk Import tab to migrate an entire team at once. See Migrate from Google Workspace (Bulk).