Horilla HRMS

A comprehensive, free, and open-source Human Resource Management System (HRMS) designed to streamline HR operations and enhance organizational efficiency.

• 👥 Employee Management - Centralized workforce data with LDAP integration
• 🎯 Recruitment - End-to-end hiring process from job posting to onboarding
• 📋 Onboarding & Offboarding - Structured workflows for employee lifecycle
• ⏰ Attendance & Time Tracking - Biometric integration and automated check-in/out
• 🏖️ Leave Management - Policy enforcement, approvals, and balance tracking
• 💰 Payroll - Automated salary processing, tax calculations, and compliance
• 📊 Performance Management - Goal setting, reviews, and continuous feedback
• 🏢 Asset Management - Track and manage company resources
• 🎫 Helpdesk - Centralized HR support and ticketing system

• Which Branch Do I Want?
• Quick Start
• Installation
• Deployment
• Contributing
• Security
• Support
• License

• 2.0 (default) — the latest stable v2 snapshot. This is what a plain git clone gives you. Use it to run or deploy Horilla.
• dev/v2.0 — the active integration branch. If you want to contribute code, branch from and open PRs against this, not 2.0.
• 1.0/master — v1, now deprioritized (fixes considered case-by-case, no guaranteed schedule). Not deleted, but no longer where active development happens.

See Discussion #1127 for full background on this transition.

Published for linux/amd64 and linux/arm64 as horilla/horilla-hr:

docker pull horilla/horilla-hr:2.1.5

Pin an exact version in production rather than latest, so a deploy cannot pick up a new release unattended; see all tags for the current one. The repository overview documents every environment variable, the volumes to back up, and a working Compose file.

First boot applies the full migration set before the web server binds, which takes a few minutes on an empty database.

# Clone the repository (defaults to the stable 2.0 branch)
git clone https://github.com/horilla/horilla-hr.git
cd horilla-hr

# Start with Docker Compose
docker compose up -d

# Access the application
open http://localhost:8000

Full Docker guide, including production deployment: docker/README.md

Requires Python 3.12, 3.13 or 3.14, and pip 21.3 or newer. Python 3.15 is not usable yet: spacy declares Requires-Python <3.15 and is imported at module scope, so the app cannot start on it.

# Clone and setup (defaults to the stable 2.0 branch)
git clone https://github.com/horilla/horilla-hr.git
cd horilla-hr

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Upgrade pip FIRST. A venv inherits the system pip, and an older one does not
# recognise current manylinux wheel tags -- it then tries to compile packages
# like cryptography and PyMuPDF from source, which needs a C toolchain most
# machines do not have. The Docker build already does this; do the same here.
python -m pip install --upgrade pip

# Install dependencies
pip install -r requirements.txt

# Setup environment
cp .env.dist .env
# Edit .env with your configuration

# Initialize database
python manage.py migrate
python manage.py compilemessages
python manage.py collectstatic

# Run development server
python manage.py runserver

For detailed installation instructions, configuration guides, and platform-specific setup instructions, please visit our comprehensive documentation:

Our documentation includes:

• Step-by-step installation for all supported platforms
• Database configuration guides
• Environment setup instructions
• Production deployment best practices
• Troubleshooting common issues
• Advanced configuration options

For production deployment guides including Nginx, Apache, and cloud platforms:

We welcome contributions! Please see our Contributing Guide for details.

# Fork and clone your fork
git clone -b dev/v2.0 https://github.com/YOUR_USERNAME/horilla-hr.git
cd horilla-hr

# Add upstream remote
git remote add upstream https://github.com/horilla/horilla-hr.git

# Create feature branch
git checkout -b feature/your-feature-name

# Install development dependencies
pip install -r requirements.txt

# Submit pull request

Note: 2.0 is the repo default, so GitHub pre-selects it as your PR base. Before submitting, change the base branch to dev/v2.0 — that's where active development and reviews happen, not 2.0.

• Follow PEP 8 for Python code
• Use Black for code formatting
• Write tests for new features
• Update documentation for user-facing changes

• 🔐 Authentication & Authorization - Role-based access control
• 🛡️ Data Protection - Encrypted sensitive data storage
• 🔍 Audit Trails - Comprehensive activity logging
• 🚫 Input Validation - XSS and injection protection
• 🔒 Session Security - Secure session management

Please report security vulnerabilities via GitHub Private Vulnerability Reporting, not email. Do not create public GitHub issues for security vulnerabilities. See SECURITY.md for full details.

• Always use HTTPS in production
• Regularly update dependencies
• Use strong passwords and enable 2FA
• Monitor logs for suspicious activities

• 📖 Documentation: docs.horilla.com
• 💬 GitHub Discussions: GitHub Discussions
• 🐛 Bug Reports: GitHub Issues
• ✨ Feature Requests: GitHub Issues

For enterprise support, custom development, and consulting services:

• 📧 Email: [email protected]
• 🌐 Website: www.horilla.com

This project is licensed under the LGPL-2.1 License - see the LICENSE file for details.