Skip to content
github-actions[bot] edited this page Nov 19, 2026 · 3 revisions

JobWarden

The keeper of your job hunt. Save job postings from your browser in one click, and keep every application's story, from the first save to the offer. Self-hosted: it runs on your own computer, with your data in your own PostgreSQL, in 8 languages. Its AI features run on the assistant you already have (Claude Code or Codex), on your own plan: JobWarden needs no API key and sends nothing anywhere.

Watch JobWarden in under 3 minutes
▶ JobWarden in under 3 minutes

Start here

🐳 Installing Docker Docker on a Mac, Windows, Linux, a Raspberry Pi or a NAS, if you don't have it yet
🚀 Installation Run it with Docker in two commands, or from the sources
👋 Getting started Your first profile, your first saved job, and the five minutes that make the rest work
⬆️ Updating Back up, upgrade, keep your data
⚙️ Configuration Every setting, and the database password
🩺 Operations Health checks, logs, and what to do when something's wrong

Using it

📋 Tracking jobs The jobs list, the pipeline, the calendar and reminders, statistics, export and import
🔎 Finding jobs The AI Assistant page, the Search Builder, the watchlist, Who's hiring, and how well you fit
📄 Your CV and applying The CV, tailored CVs, cover letters, messages, interview prep, Auto-apply
💶 Offers and salaries What jobs and the market pay, offers side by side, negotiating
✉️ Inbox Recruiters' emails turned into updates of your jobs
🤖 AI assistant Connecting Claude Code or Codex, and what they do for you
🧩 Browser extension Saving postings from Chrome and Firefox
👤 Profiles and settings Several job hunts on one server, and every setting on the Settings page

Under the hood

🏗️ What's what The modules, the packages, and the conventions the build checks
🛠️ Development Building, testing, translating and releasing

Every page in JobWarden also has a How it works button, next to its title, with a short guide to that page.

Help and ideas

Clone this wiki locally