frappe/hrms

What is it?

Key features

• 01Employee lifecycle management from onboarding to exit interviews
• 02Leave policies, regional holiday import, and attendance reports
• 03Geolocation-based check-in and check-out
• 04Expense claims and advances with multi-level approval workflows
• 05Performance management with goals, KRAs, and self-evaluation
• 06Payroll with salary structures, income tax slabs, and salary slips

Use cases

• Running HR and payroll for a small or mid-sized company on self-hosted infrastructure
• Managing leave, attendance, and expense approvals for a team already using ERPNext
• Handling appraisal cycles with goal tracking and employee self-assessment
• Recruiting and onboarding new hires within an open-source HR stack

Quick start

1. 1

   Install Docker, docker-compose and git, then clone the repository

   git clone https://github.com/frappe/hrms
2. 2

   Enter the docker directory and start the stack

   cd hrms/docker docker-compose up
3. 3

   Open http://localhost:8000 and log in as Administrator with password admin once the setup finishes

Things to know

• !Running it locally requires setting up the Frappe bench framework first, which is a multi-step process.
• !Frappe HR is built on the Frappe Framework and is designed to run alongside ERPNext, so it adds dependencies.
• !Licensed under GPL-3.0, a copyleft license that requires derivative works to be distributed under the same terms.

Topics

FAQ

What is hrms?

Open-source HR and payroll software covering employee lifecycle, leave, attendance, expenses, performance, and payroll, built on the Frappe Framework. Frappe HR is a self-hosted HRMS and payroll application. It covers employee lifecycle tasks such as onboarding, promotions, transfers, and exit interviews, along with leave policies, regional holiday imports, geolocation-based check-in and check-out, and attendance reports.

Is hrms free to use? What license does it have?

hrms is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is hrms still maintained?

Actively maintained. The last commit to hrms was on Oct 21, 2026.

What can I use hrms for?

Running HR and payroll for a small or mid-sized company on self-hosted infrastructure Managing leave, attendance, and expense approvals for a team already using ERPNext Handling appraisal cycles with goal tracking and employee self-assessment Recruiting and onboarding new hires within an open-source HR stack

How do I install hrms?

Install Docker, docker-compose and git, then clone the repository: git clone https://github.com/frappe/hrms Enter the docker directory and start the stack: cd hrms/docker docker-compose up Open http://localhost:8000 and log in as Administrator with password admin once the setup finishes

Where can I get hrms?

The source code and installation instructions are on GitHub: https://github.com/frappe/hrms