Homepage
Configuration

IMAP

Step by step email setup guide.

Update Email Settings

Configure your email for IMAP usage.

Step 1 of 4: Email Address

  • Enter your email address.
  • Provider is auto-detected.
  • Some providers (like Outlook) require OAuth2.

Step 2 of 4: Password

  • For OAuth2 providers, password entry is skipped.

Step 3 of 4: Start OAuth Flow

  • Type y to start the OAuth authentication flow.
  • A browser window will open so you can log in with your email provider.
  • Currently required for Outlook.

Step 4 of 4: Catchall Domain

  • Enter your catchall domain (e.g., example.com).
  • This is optional and does not require further setup.
  • Catchall will not work for IMAP — you still need a master email set up in Step 1 for receiving codes.

App Password Setup Guide

If your provider uses two-factor authentication (2FA), you must create an App Password for IMAP access.

Gmail

  1. Go to myaccount.google.com/security.
  2. Under "Signing in to Google", enable 2-Step Verification.
  3. After enabling, return and select App passwords.
  4. Choose Mail as the app and Other (Custom name) if needed.
  5. Copy the generated 16-character password and use it instead of your normal one.

iCloud (Apple)

  1. Go to appleid.apple.com.
  2. Sign in and go to Security > App-Specific Passwords.
  3. Click Generate an App-Specific Password.
  4. Enter a label (e.g., “IMAP Setup”) and click Create.
  5. Copy the password shown and use it in place of your regular password.

Yahoo Mail

  1. Go to login.yahoo.com/account/security.
  2. Enable 2-Step Verification if not already active.
  3. Click Generate app password.
  4. Select Mail as the app, then click Generate.
  5. Copy the generated password and use it instead of your main password.