Verify your download
Every release ships a SHA256SUMS file. Check the archive against it before you unpack.
- Download the archive and the checksum file into the same folder
curl -LO https://gooseplicant.goosenotes.dev/downloads/0.7.0/gooseplicant-0.7.0.tar.gz curl -LO https://gooseplicant.goosenotes.dev/downloads/0.7.0/SHA256SUMS - Check it
On macOS or Linux, check the archive you downloaded:
grep ' gooseplicant-0.7.0.tar.gz$' SHA256SUMS | shasum -a 256 -cIt prints
gooseplicant-0.7.0.tar.gz: OK. If you downloaded both archives,shasum -a 256 -c SHA256SUMSchecks them all; on Linuxsha256sum -cworks the same way.On Windows (PowerShell), compare the output with the SHA-256 shown above:
(Get-FileHash .\gooseplicant-0.7.0.zip -Algorithm SHA256).Hash.ToLower() - Unpack it
tar -xzf gooseplicant-0.7.0.tar.gz cd gooseplicant-0.7.0Then follow
INSTALL.mdin the kit, or the guides here: One server (recommended), which continues withcd gooseplicant-0.7.0/deployand./goose setup; or by hand with Docker, Node.js or Cloudflare.
System requirements
Pick one runtime. Each needs a way to sign HR people in and, if you want to send email, a mail service.
| Install path | You need |
|---|---|
| One server (recommended) | A Linux machine (or a Mac, for trying it) with Docker Engine and the Compose v2 plugin, openssl and curl; a domain whose DNS is on Cloudflare (free plan is fine) and an API token for it. Sign-in (Authelia) and HTTPS (Caddy) are included. Optional: Tailscale for staff working from home, SMTP for sign-in codes. |
| Docker | Docker with BuildKit (the image is built from the kit) and Docker Compose for the proxy example. The image is based on Node.js 26. An authenticating reverse proxy in front. |
| Node.js | Node.js >=22.18 and npm, a process supervisor such as systemd, disk space for the SQLite database and uploads, and an authenticating reverse proxy in front. |
| Cloudflare | A Cloudflare account with a domain (zone) on it, Workers, D1, R2 and Cloudflare Zero Trust (Access). Node.js >=22.18 and npm on your machine to run Wrangler. |
| Email (optional) | SMTP or a Microsoft 365 mailbox via Microsoft Graph (self-hosted), or Microsoft Graph (Cloudflare). |
Cloudflare plans. Nothing in the code requires a paid Workers plan: it uses D1, R2, a Cloudflare Access application, a Cron Trigger and Workers Static Assets. Free tiers have usage and per-request CPU limits, and some products ask for a payment method before you enable them, so check Cloudflare's current pricing and limits for your expected volume.
What's in the kit
INSTALL.mdandREADME.md: the short version of the guides on this site.deploy/: the one-server setup.goose(the setup and maintenance script),compose.yml(Gooseplicant, Authelia, Caddy and cloudflared),caddy/Dockerfile(Caddy with the Cloudflare DNS plugin),templates/for the generated configuration,README.mdand its tests. Your settings, secrets and backups are created here by./goose setup; they are never part of a release. See Set up on one server.apps/node/: the self-hosted runtime, itsDockerfile,docker-compose.example.ymland.env.example.apps/cloudflare/: the Worker,wrangler.toml(with placeholders) and.dev.vars.example.packages/core,packages/http: the shared domain logic and HTTP layer, as TypeScript sources that Node.js runs directly.packages/import: the email and PDF reader behind Import, which runs in the browser.packages/ui/dist: the prebuilt web apps, the Gooseplicant HR app and Gosling (their sources are included too).docs/ARCHITECTURE.md,docs/LITE.md(the Gosling design),LICENSEandTHIRD_PARTY_NOTICES.md.
Older versions
- 0.6.1 · October 15, 2026 — gooseplicant-0.6.1.tar.gz · gooseplicant-0.6.1.zip · SHA256SUMS
- 0.6.0 · October 15, 2026 — gooseplicant-0.6.0.tar.gz · gooseplicant-0.6.0.zip · SHA256SUMS
- 0.5.1 · October 15, 2026 — gooseplicant-0.5.1.tar.gz · gooseplicant-0.5.1.zip · SHA256SUMS
- 0.5.0 · October 15, 2026 — gooseplicant-0.5.0.tar.gz · gooseplicant-0.5.0.zip · SHA256SUMS
- 0.4.0 · October 14, 2026 — gooseplicant-0.4.0.tar.gz · gooseplicant-0.4.0.zip · SHA256SUMS
- 0.3.0 · October 14, 2026 — gooseplicant-0.3.0.tar.gz · gooseplicant-0.3.0.zip · SHA256SUMS
- 0.2.0 · October 14, 2026 — gooseplicant-0.2.0.tar.gz · gooseplicant-0.2.0.zip · SHA256SUMS
- 0.1.0 · October 14, 2026 — ats-0.1.0.tar.gz · ats-0.1.0.zip · SHA256SUMS
License
Licensing terms TBD. The kit includes a LICENSE file with the terms that apply to that release.