Help
Quick answers to the things people ask. If you're stuck, the GitHub issues page is the right place to ask for help.
Getting started
What is jobhunt?
A local-first job search app. It pulls listings from 130+ company career pages, normalises them, and gives you a fast filtered search. Nothing leaves your machine — no accounts, no telemetry, no cloud.
Why are some jobs marked with a ~ before the salary?
Companies don't always publish a salary. When that happens, jobhunt
shows an estimate based on the level + region of similar
jobs in your database. The ~ prefix tells you it's
estimated rather than published.
Why does Local Jobs default to cleaning / retail / warehouse?
The Local Jobs page is for zero-experience work near you. Most people who need a job nearby want non-tech roles you can start without prior experience. Toggle What kind of work → Tech / software if you want the software path instead.
Filters explained
Career stage vs Job type
Career stage is permanent-role seniority — entry, junior, mid, senior, staff, principal, lead. Job type is the contract — full-time, part-time, contract, internship. Internship lives in Job type, not Career stage.
Max years of experience
Hides any job whose stated minimum experience is higher than your cap. Jobs without a stated minimum always pass through, so you'll still see the unlabelled ones.
Languages / Skills
Comma-separated, case-insensitive. python, typescript
is two languages, not one phrase. The filter is exact-match on
tags extracted from the job description.
Min CV match
Only available after you upload a CV. The value is a 0–1 similarity score between your CV and the job. ≥0.5 is "decent fit", ≥0.7 is "very strong". Upload at /cv.
API keys
Do I need API keys?
No. jobhunt works without any keys — you'll still get 100+ job sources. Keys unlock extra coverage:
- Jooble — free, unlocks 69 countries of generalist data.
- Reed — free, unlocks UK Reed.co.uk (incl. non-tech for Local Jobs).
Both at Settings. After pasting a key click Test keys to verify it works.
My key says "rejected (401)"
The provider says the key is invalid. Either you copied the wrong thing, the key was revoked, or you're on a free-tier rate-limit cooldown. Regenerate it at the provider's developer page and paste the new key.
Updates + uninstall
How do I update jobhunt?
Open Settings, click Check for updates. If a new version exists, an Install update button appears — click it and restart jobhunt when prompted. Or re-run the install command from your terminal; it's idempotent and forces a fresh download.
How do I uninstall?
Open Settings, click Uninstall jobhunt. That's it on Mac/Linux/Windows installs. Your saved data folder is left alone — delete it manually for a fully clean removal.
Troubleshooting
"No jobs found" everywhere
You probably haven't refreshed yet. Click Refresh sources in the top nav. The first refresh takes about a minute as it pulls from every configured source.
"Internal server error" after clicking Update
Restart jobhunt — closing and reopening the window picks up the new code. The install left files in a half-state and the running process is still using the old code.
"X sources offline" on Settings
Some company career pages have moved. jobhunt auto-skips sources that have failed three times in a row. Open Source Health to see which ones, or wait — the project's source-maintenance routine will repair them at the next release.
Privacy + data
Where is my data stored?
On your machine only. The path is shown on Settings → About.
Windows: %APPDATA%\jobhunt. macOS:
~/Library/Application Support/jobhunt. Linux:
~/.local/share/jobhunt.
Does jobhunt phone home?
No. There's no telemetry, no update pings, no analytics. The only outbound traffic is to the job sites themselves when you refresh. The web UI binds to 127.0.0.1 only — your machine, not your local network.