Repository navigation
Installation
JobWarden is a server you run yourself: on your own computer, or one on your network. The pages open in any browser; the browser extension saves postings to it; your AI assistant connects to it.
JobWarden has no sign-in, by design. Whoever can reach the server can read and change your job hunt, so keep it to your own computer or network. SECURITY.md says what to keep in mind before exposing it to anything else.
You need Docker with Compose. No Docker yet? Installing Docker shows how, on a Mac, Windows, Linux, a Raspberry Pi or a NAS. The image runs on Intel and AMD computers (amd64) and on ARM ones (arm64): Apple Silicon Macs, ARM laptops, a Raspberry Pi 4 or 5 with a 64-bit system, ARM NAS boxes. Not on 32-bit ARM, which Java 25 isn't made for.
-
Make a folder for JobWarden, and download the latest release's
compose.yamlinto it. It runs JobWarden's image (ghcr.io/crv96/jobwarden) with PostgreSQL.mkdir ~/jobwarden && cd ~/jobwarden curl -L -o compose.yaml https://github.com/CRV96/jobwarden/releases/latest/download/compose.yaml
-ois a lowercase letter o, followed by the file's name. On Windows, in PowerShell, writecurl.exeinstead ofcurl. Or downloadcompose.yamlfrom Releases by hand. -
In that folder:
docker compose up -d
-
Open http://localhost:9273.
That's it. The first start takes a minute: Docker downloads the images, and JobWarden creates its database's tables.
Where your data is: in two Docker volumes, never in a container: postgres-data, the database, and jobwarden-key,
the key that encrypts the mailboxes' passwords and GitHub tokens. Updating replaces the container and keeps both: see
Updating. Keep the folder: Compose names the volumes after it.
Worth setting, in a .env file next to compose.yaml:
TZ=Europe/Bucharest # the time zone "today" and every time on the pages are in (UTC otherwise)
POSTGRES_PASSWORD=... # the database's password, for a new database; afterwards change it in Settings → DatabaseThe port is published on this computer only (127.0.0.1:9273). Every other setting is on
Configuration.
JobWarden is a web page, but it can have a window and an icon of its own, in the Dock or on the taskbar, like any app. With JobWarden running, open http://localhost:9273, then:
- Safari (macOS Sonoma or later): File → Add to Dock…, then Add. It opens from the Dock, Launchpad or Spotlight, with JobWarden's icon. Safari's apps keep their own cookies, so pick your profile once more in it.
- Chrome: the ⋮ menu → Cast, save, and share → Install page as app…, then Install. It shares your browser's cookies, profile included. On a Mac it goes in Applications → Chrome Apps: while it's open, right-click its icon in the Dock → Options → Keep in Dock. On Windows, right-click it on the taskbar → Pin to taskbar.
- Edge: the … menu → Apps → Install this site as an app.
It's the same JobWarden as in your browser, so it opens only while JobWarden runs: with Docker, after Docker has started.
You need JDK 25 or later and Docker (for the database). Clone the repository, then:
./mvnw -pl app -am spring-boot:runThe app starts its own PostgreSQL container from app/compose.yaml, then opens on http://localhost:9273. The first
build downloads Maven's dependencies and its own Node, for the CSS: nothing else needs installing.
Development has the rest: tests, the CSS while editing templates, releases.
Run the jar (from a release, or ./mvnw -pl app -am package) with Java 25
against a PostgreSQL 18 of your own:
java -jar jobwarden-app-1.0.1.jar \
--spring.datasource.url=jdbc:postgresql://localhost:5432/jobwarden \
--spring.datasource.username=jobwarden --spring.datasource.password=...The schema is JobWarden's own: it creates and upgrades it as it starts. It keeps its key in ~/.jobwarden.
- Getting started: your profile, your first saved job.
- The browser extension, to save postings in one click.
- Your AI assistant, for the AI features.
JobWarden · Releases · Discord · Suggest a feature · Report a bug · MIT License