Repository navigation
Releases
Releases · Crow-Tech-Pte-Ltd/CrowHR
Crow HR 1.0.0
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, pluspostgres:17-alpine. Install with.env+docker compose up -d; first-run setup wizard; automatic migrations with a lock; scheduled and manual backups (encrypted withBACKUP_PASSPHRASE) and restore; thecrowhrCLI; 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