hrms
Open-source HR and payroll software for employee records, attendance, leave, expenses, appraisals and salary processing.
- Stars
- 9.0k
- Forks
- 2.9k
- Last update
- 4 Nov 2026
Overview
Frappe HR brings employee management, leave, attendance, expenses and payroll into one system. Built on Frappe Framework, it supports configurable workflows, mobile access and integrated accounting with ERPNext.
Who it's for
Tech stack
Features and benefits
Key features
- Manage onboarding, promotions, transfers and exit interviews.
- Configure leave policies, holidays and leave balances.
- Track attendance with geolocation check-ins, rosters and auto attendance.
- Manage employee advances and expense claims with multi-level approvals.
- Track goals, key result areas, self-evaluations and appraisal cycles.
- Create salary structures, income tax slabs, additional salaries and off-cycle payments.
- Use the mobile app for leave requests, approvals, check-ins and employee profiles.
- Manage recruitment planning and candidate evaluation.
- Customize fields, forms, reports, print formats, workflows and permissions.
Why it helps in Pakistan
- Keep employee records and HR processes together rather than scattered across separate systems.
- Reduce manual payroll work with salary structures and payroll processing.
- Make leave and expense approvals easier to manage through configurable workflows.
- Connect HR expenses and payroll with ERPNext accounting.
- Let employees and managers handle common HR tasks from their phones.
Pakistan use cases
- 01
A Lahore software company can manage onboarding, remote check-ins and leave approvals.
- 02
A Karachi distributor can track staff expense claims and advances alongside ERPNext accounting.
- 03
A Faisalabad manufacturer can manage employee rosters, attendance and salary structures.
- 04
An Islamabad services firm can organize goals, self-evaluations and appraisal cycles.
Requirements
- Hardware
- Check the official docs
- Operating system
- Check the official docs
- Skills
- Command-line use for the documented development setupDocker, docker-compose and Git setup for the Docker methodFrappe Bench setup for the local method
- Accounts needed
- Docker development login: Administrator / adminFor managed hosting account requirements: Check the official docs
Setup guide
Commands are copied from the project's README and official docs.
- 1
Prepare the development environment
The README requires Docker, docker-compose and Git. This method is documented for development, not production. Check the official docs for prerequisite installation.Not fully covered in the README. Check the official docs before running this step.
- 2
Clone the repository
Rungit clone https://github.com/frappe/hrms. - 3
Open the Docker directory
Runcd hrms/docker. - 4
Start the environment
Rundocker-compose upand wait until the setup script creates a site. - 5
Open Frappe HR
Visit http://localhost:8000 and log in with username Administrator and password admin.
Works with
ERPNext accounting
Connect expense claims, advances and payroll with ERPNext accounting.
External ERP and accounting systems
Use REST APIs and webhook support to connect external software; individual connectors are not specified.
Biometric tools and banks
The official website mentions integration with biometric tools and banks, but does not provide supported models, banks or setup instructions in the supplied sources.
What it costs
| Software | Free to self-host under the GPL-3.0 licence. |
|---|---|
| Hosting | Budget for server hosting and maintenance. The supplied sources do not state RAM or CPU requirements, so a sized VPS estimate is not available; check the official docs and current provider prices. |
| Paid cloud option | Official managed hosting is available through Frappe Cloud, including installation, upgrades, monitoring, maintenance and support. Check current plans. |
FAQ
Does Frappe HR include Pakistan-specific payroll compliance?
It supports configurable income tax slabs and regional tax regulations. The supplied sources do not confirm Pakistan-specific tax rules or statutory compliance, so verify local requirements before using it for payroll.
Can employees use it from a phone?
Yes. The mobile app supports leave requests and approvals, check-ins, check-outs and access to employee profiles.
Is the Docker quick start suitable for production?
The README lists Docker and local Bench instructions under development setup. Its production section recommends managed hosting through Frappe Cloud.
Can I customize HR policies and approvals?
Yes. Frappe HR supports custom fields, forms, workflows, multi-level approvals, leave rules and appraisal cycles.
Which open-source licence applies?
The supplied repository metadata lists GPL-3.0, while the website includes an AGPL-3.0 label. This listing follows the repository metadata; verify the licence for the exact version you deploy.
Troubleshooting
The Docker login page does not appear.
Wait for the setup script to finish creating the site, then open http://localhost:8000. If it still fails, check container logs and port availability; see the official docs.
The local development site cannot be reached.
Keep bench start running, confirm that bench --site hrms.localhost add-to-hosts completed, and use http://hrms.localhost:8080. For further checks, see the official docs.
The Docker development login fails.
Use the README's development credentials: username Administrator and password admin. If these do not work on your environment, see the official docs.
Docker setup commands fail.
Confirm Docker, docker-compose and Git are installed, and run the startup command from hrms/docker. Check logs and installed versions; see the official docs.
Official links
Get it set up for you
Don't want to install it yourself? A Jugaad maker can set up hrms for your business. Payment is held in Safe Deal until it works.
No maker offers a setup gig for this yet. Post a request and makers will quote.
Related tools
erpnext
by frappe
ERPNext brings accounting, inventory, manufacturing, assets, and projects into one open-source business management system.
- A Karachi distributor can track…
- A Faisalabad manufacturer can tr…
- A Lahore services company can ma…
idurar-erp-crm
by idurar
IDURAR is a self-hosted ERP and CRM for managing invoices, quotes, payments and customers, built on the MERN stack.
- A Lahore software agency can man…
- A Karachi consultancy can organi…
- An Islamabad service business ca…
Built by frappe and contributors on GitHub. All credit goes to the authors. GitHub stats refresh daily. Jugaad does not host, copy or sell this code.
Is this your project?
