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://ats.goosenotes.dev/downloads/0.1.0/ats-0.1.0.tar.gz curl -LO https://ats.goosenotes.dev/downloads/0.1.0/SHA256SUMS - Check it
On macOS or Linux, check the archive you downloaded:
grep ' ats-0.1.0.tar.gz$' SHA256SUMS | shasum -a 256 -cIt prints
ats-0.1.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 .\ats-0.1.0.zip -Algorithm SHA256).Hash.ToLower() - Unpack it
tar -xzf ats-0.1.0.tar.gz cd ats-0.1.0Then follow
INSTALL.mdin the kit, or the guides here: Docker, Node.js, 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 |
|---|---|
| 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.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/ui/dist: the prebuilt web app (its sources are included too).docs/ARCHITECTURE.mdandLICENSE.
Older versions
This is the first release.
License
Licensing terms TBD. The kit includes a LICENSE file with the terms that apply to that release.