Skip to content

Releases

Crow HR 1.0.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 12:35
99414d7

The first public release: free, MIT-licensed HR and payroll for Singapore SMEs that you host yourself.

Crow HR has not yet been used for a real company's payroll. Check its results before you pay or file, and read the project status and the known limitations (full list: docs/limitations.md) before you rely on it.

Included

  • Self-hosting: one Docker image for amd64 and arm64 at ghcr.io/crow-tech-pte-ltd/crowhr, plus postgres:17-alpine. Install with .env + docker compose up -d; first-run setup wizard; automatic migrations with a lock; scheduled and manual backups (encrypted with BACKUP_PASSPHRASE) and restore; the crowhr CLI; Settings → System.
  • Sign-in and security: email and password with TOTP two-step verification, Google Workspace, Microsoft Entra ID and generic OpenID Connect SSO, Singpass (tested against Singpass staging only), a server-enforced permission matrix and an append-only, hash-chained audit log.
  • People: company structure, employee records with effective-dated history, CSV import, lifecycle events, work passes, self-service change requests.
  • Approvals and notifications: approval policies, delegation and escalation, a Home work-to-do list, in-app and email notifications.
  • Leave, attendance and scheduling: statutory and company leave types with accrual and carry-forward, clock in and out with an offline queue, timesheets and overtime claims, shift rosters with swaps and open shifts.
  • Claims: claim types with caps, receipts, foreign currency at manual rates, reimbursement through payroll or outside it.
  • Payroll: monthly, off-cycle and adjustment runs with CPF, SHG, SDL and an FWL estimate from cited, effective-dated rules (packages/sg-rules); payslips; the CPF EZPay file, an ISO 20022 bank file and an IR8A export to upload yourself. Nothing is submitted to CPF Board, IRAS or banks directly.
  • Documents and reports: employee documents, HR letters and KETs from templates, acknowledgements; reports with CSV and XLSX export.
  • Optional error monitoring: send errors, performance traces and logs to your own Sentry-compatible service (for example GlitchTip) by setting SENTRY_DSN / SENTRY_BROWSER_DSN. Off by default: without them the SDK is never loaded. Tokens, query strings, failed-query values, NRIC/FIN and email addresses are redacted, and nothing goes to Crow Tech.
  • API: the versioned REST API (/api/v1) the web app uses, documented with OpenAPI.
  • Demo: the same app running in your browser with a fictional company at hr.crow.sg.

Not included yet

  • The iOS app (iPhone and iPad, with iPad layouts: a sidebar, readable widths, payslips beside the list, Split View and Slide Over) and the Android app are built but not in the App Store or Google Play.
  • Direct submission to CPF, IRAS or banks; virus scanning of uploads (a hook only; bring your own ClamAV).
  • Production Singpass has not been tried, and the Singpass button needs the official logo, which you add yourself.

Docker image

ghcr.io/crow-tech-pte-ltd/crowhr:1.0.0 for linux/amd64 and linux/arm64, also tagged 1.0, 1 and latest. Install or upgrade with the install guide or upgrades. Check where it was built:

gh attestation verify oci://ghcr.io/crow-tech-pte-ltd/crowhr:1.0.0 --owner Crow-Tech-Pte-Ltd