An open-source Human Resource Information System and Philippine payroll platform for growing organisations. It brings employee records, attendance, leave and overtime requests, payroll processing, statutory contributions, payslips, and reporting into one workspace..
Status: the project is being prepared for public release. Please read SECURITY.md before deploying it or sharing a fork.
Try it: the hosted demo is at https://openhrph.laravel.cloud. Create an account, confirm the email we send you, and your own sample workspace opens with demo employees and payroll.
- People — employee profiles, documents, certificates, training, schedules, compensation, loans, allowances, bonuses, and commissions.
- Time and attendance — biometric device imports, timesheets, attendance corrections, overtime, undertime, leave, official business, and schedule adjustments.
- Payroll — payroll groups, period previews, review, approval and locking, payslips, registers, and remittance reports.
- Statutory compliance — effective-dated tables for the installation's country. The Philippines ships with SSS, PhilHealth, Pag-IBIG, GSIS, BIR withholding tax and minimum-wage tables; other countries are configured through generic statutory components.
- Multi-company — one installation can serve several companies with tenant-scoped data and per-company settings.
- Access control — owner accounts, groups, granular permissions, and a separate employee self-service portal.
- Two admin experiences — a first-party Livewire admin at
/appand an optional Filament panel.
| Layer | Technology |
|---|---|
| Backend | PHP 8.3+, Laravel 13 |
| Admin UI | Livewire 3, Blade, Tailwind CSS 4, Vite 8 |
| Optional admin panel | Filament 3 |
| Payroll engine | Go 1.24 (MySQL-backed, with a PHP fallback) |
| Data | MySQL 8 (SQLite for tests and the desktop build) |
| Queues and realtime | Database/Redis queues, Laravel Reverb |
| Desktop | NativePHP Desktop 2 (Electron + bundled PHP + SQLite) |
| Reporting | Maatwebsite Excel, FPDF/FPDI, PHPWord |
- PHP 8.3 or newer with the usual Laravel extensions (
bcmath,ctype,curl,dom,fileinfo,gd,intl,mbstring,openssl,pdo_mysql,tokenizer,xml,zip) - Composer 2
- Node.js 22 and npm
- Go 1.24 (only for the payroll engine)
- MySQL 8 (SQLite is used only by the automated tests)
git clone https://github.com/kawayanmedia/openhrph.git
cd hris
composer install
cp .env.example .env
php artisan key:generate
# Create and initialise the MySQL database
mysql -u root -p -e 'CREATE DATABASE hris CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;'
php artisan migrate
# Government or Private for the whole installation, and the payroll country
php artisan openhr:install
php artisan admin:create
npm ci
npm run build
# Optional: build the Go payroll engine
make -C payroll-engine build
php artisan serveOpen http://127.0.0.1:8000/app/login and sign in with the account created by admin:create.
The database is created entirely from the migrations in
database/migrations. They are guarded withSchema::hasTableandSchema::hasColumn, so the same command also upgrades an existing installation.openhr:installseeds the leave type and compensation catalogues, which are system-wide: one set of shared rows plus an optional sector tag, with per-company overrides.
For the full setup, including the payroll engine, queues, Vite dev server, and demo data, read Local development.
Start at the documentation hub.
The same content is published as a searchable site at kawayanmedia.github.io/openhrph, with a light/dark theme and the workspace screenshots. To run it locally:
cd docs-site
npm ci
npm startThe site reads docs/ directly, so there is nothing to keep in sync. See
docs-site/README.md for the build and deployment details.
- Company to payslip walkthrough
- Getting started
- Employees
- Attendance and requests
- Payroll
- Reports and payslips
- Settings and access
- Troubleshooting
- Architecture
- Local development
- Admin panel
- Payroll engine
- Testing
- Multi-tenancy
- Docker deployment
- AWS AMI deployment
- GCP deployment
- Azure deployment
- Operations
vendor/bin/pest # PHP unit and feature tests (SQLite)
make -C payroll-engine test # Go payroll engine tests
npm run e2e # Playwright browser tests
npm run e2e:dark # Playwright dark-mode projectBrowser tests run against E2E_BASE_URL (defaults to APP_URL) and use an isolated seeded company. They never touch real payroll data. See Testing.
- Docker — build the application image and run the Compose stack: Docker deployment.
- AWS — build a golden AMI with Packer and launch it with Terraform: AWS AMI deployment.
- GCP — build a golden image with Packer and launch it with Terraform: GCP deployment.
- Azure — build a managed image with Packer and launch it with Terraform: Azure deployment.
- Laravel Cloud / Vapor — see Laravel Cloud for the managed-hosting path.
- Desktop app — build a standalone macOS, Windows, or Linux app with NativePHP: Desktop app. It bundles SQLite, runs the parity-locked PHP payroll driver, and updates from GitHub Releases.
The Go payroll binary must exist on the server. The Docker image and the AWS, GCP, and Azure golden images build it automatically; other deployments must add make -C payroll-engine build to their release step. The desktop build does not use it.
Please do not open a public issue for a security problem. Read SECURITY.md for the disclosure process.
Before publishing a fork, review the open-source release checklist. It covers credential rotation, history cleanup, and PII checks.
Contributions are welcome. Read CONTRIBUTING.md for the development workflow, coding conventions, and pull-request checklist.
Released under the MIT License.