{% extends "onboarding/_base.html" %} {% block title %}Gmail IMAP credentials — Onboarding{% endblock %} {% block content %}

Job sources

Choose where Job Cannon looks for jobs. Free portals work immediately with no account; Gmail IMAP arrives after you set up job-alert emails.

Searches RemoteOK, Remotive, and Himalayas using your target job titles as keywords. These portals return full job descriptions, so jobs are AI-scored on the same sync they arrive — no extra enrichment step. Disable only if you want inbox-only ingestion.

Connect Gmail (IMAP)

Job Cannon ingests job-alert emails from your Gmail inbox over IMAP using a Google App Password — a one-purpose, 16-character password you generate for this app. We never see or store your Google account password.

{# Google-UI instructions — verified 2026-06; re-verify against a no-2FA test account before each release (see the release checklist). #}

What you need

  1. Step 1 — Enable 2-Step Verification

    Google requires 2-Step Verification before they will let you create App Passwords. If you already have it on, you can skip this link.

    Don't have 2-Step Verification yet? Click for a 2-minute walkthrough
    1. Open the 2-Step Verification page (sign in if prompted) and click Turn on 2-Step Verification / Get started. Google may ask for your password again.
    2. Pick your second step. If you're signed in to Google on your phone, the easiest is the Google prompt — Google sends an "Is this you?" tap-to-approve notification. Otherwise choose phone number and Google texts you a code.
    3. Enter the code / approve the prompt, then click Turn on.
    4. That's it — now the App Passwords link in Step 2 will work. (Without 2-Step Verification, that page doesn't exist at all.)

    This protects your whole Google account, not just Job Cannon — it's worth having regardless.

  2. Step 2 — Generate an App Password

    This is the page where you generate the 16-character password Job Cannon will use for read-only access to your job-alert emails.

{# Google-UI instructions — verified 2026-06 (single App-name field + Create button; the old Mail / Other-device dropdowns are gone). Re-verify before each release. #}

On the App Passwords page

  1. Sign in if prompted. (This page only exists once 2-Step Verification is on — if it looks empty or errors, do the 2-Step Verification walkthrough above first.)
  2. Type Job Cannon in the App name field and click Create.
  3. Copy the 16-character password from the popup — spaces included — and paste it below. Google shows it only once; if you lose it, just delete it and create a new one.

Can't find the page from the menus? Type app passwords in the search box at the top of myaccount.google.com.

Why am I doing this?

Job Cannon reads job-alert emails (LinkedIn, Glassdoor, ZipRecruiter, etc.) from your inbox over IMAP using a Google-issued one-purpose password. The password is stored in your OS keyring (Windows Credential Manager / macOS Keychain) — not in any plaintext file we can read, and never sent off your machine.

{% if error %}
{{ error }}
{% endif %}
{% endblock %}