Check its license. It has its own license: read it before using it for work.

Is horilla-hr still maintained?

Yes, active. Last change today. Latest release 2.4.0, 3 days ago.

How widely used is horilla-hr?

Widely used. 1.5k stars, 3 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to set up horilla-hr (horilla/horilla-hr) · gitmanual

Assembly instructions

horilla/horilla-hr

Horilla is a free and open source HR software.

PythonDjango#attendance#biometrics#django#hr

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Still maintained?: Yes, activeLast change today. Latest release 2.4.0, 3 days ago.
How widely used?: Widely used1.5k stars, 3 years old, by an organization. As with any download, get it from the official repo.

Difficulty: Involved
Time: 30 min or more
Stars: ★ 1,511
Activity: Updated this month

Saved setup from 7 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Supported devices from the README: Platform & Integrations

🔌 REST API - Token-based API used by the mobile app
✉️ Automations - Email and in-app notifications sent when records are created, updated or deleted
🔗 Integrations - LDAP, Google Meet, Google Drive backup and WhatsApp
🧩 Optional add-on apps - Geofencing, Face Detection and Outlook (Microsoft 365) mail ship in the repository but are not enabled by default

Your system

macOS Windows Linux

Start here

Website ↗horilla.comThe project's own site.

Also: Docs ↗

Heads-upBuilding it yourself? It also needs PostgreSQL, Redis and 16 settings in .env (3 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Choose one way. Most people should use the recommended one; the rest are other options.

Recommended: DockerNeeds Docker

docker pull horilla/horilla-hr:2.4.0

Alternative: DockerNeeds Docker

docker compose up -d

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 13 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Python 3.12runtime
1×Docker tool
1×pip package manager
1×PostgreSQL service
1×Redis service

16× settings in .env

DJANGO_SETTINGS_MODULE
SECRET_KEYsecret
DEBUG
ALLOWED_HOSTS
CSRF_TRUSTED_ORIGINS
TIME_ZONE
SECURE_SSL_REDIRECT
DB_INIT_PASSWORDsecret
DATABASE_URL
POSTGRES_DB
POSTGRES_USER
POSTGRES_PASSWORDsecret
DB_HOST
DB_PORT
REDIS_PASSWORDsecretoptional
REDIS_URLoptional

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/horilla/horilla-hr/badge.svg)](https://gitmanual.com/horilla/horilla-hr)

Good to know

Dockerfile available (base image: python:3.12-slim).
Nested projects: static/build/vendor/ionicons/@stencil/core/cli/package.json, static/build/vendor/ionicons/@stencil/core/compiler/package.json, static/build/vendor/ionicons/@stencil/core/dev-server/client/package.json, static/build/vendor/ionicons/@stencil/core/dev-server/package.json and 11 more

Details

License: LGPL-2.1
Open issues: 131
Branch: 2.0

Files we read (13)

.env.dist

.github/workflows/codeql.yml

.github/workflows/docker-ci.yml

.github/workflows/docker-publish.yml

.github/workflows/quality.yml

.github/workflows/unit-tests.yml

CONTRIBUTING.md

Dockerfile

Makefile

README.md

docker-compose.yml

pyproject.toml

requirements.txt

9,119 files in the repo

Contact

horilla/horilla-hr

Before you start

Your setup manual for horilla-hr

What's inside

Handy for

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like horilla-hr that run on macOS