---
title: "Deploy Horilla"
description: "Manage employees, attendance, leave, payroll and hiring in one app."
category: "Other"
url: https://railway.com/deploy/horilla-hr-software
---

# Deploy Horilla

Manage employees, attendance, leave, payroll and hiring in one app.

**[Deploy Horilla on Railway](https://railway.com/template/horilla-hr-software)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/horilla-hr-software/manifest.json

- **Creator:** blueorange
- **Category:** Other

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### horilla https://raw.githubusercontent.com/horilla-opensource/horilla/2.0/static/images/ui/horilla-sticker-round.png

- **Source:** https://github.com/gridalpha/horilla-railway
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

## Documentation

# Deploy and Host Horilla on Railway

![Horilla logo](https://raw.githubusercontent.com/horilla-opensource/horilla/2.0/static/images/ui/horilla-sticker-round.png)

Horilla is an open source **human resource management system (HRMS)** built with Django. It covers the whole employee lifecycle in one app: recruitment, onboarding, employee records, attendance and time tracking, leave, payroll, performance reviews, assets, an HR helpdesk, projects and timesheets, and offboarding. It is LGPL-2.1 licensed with about 1,500 GitHub stars, and 2.4.0 shipped in November 2026. This template builds Horilla's stable 2.0 branch on Railway with PostgreSQL and Redis, creates the first administrator from generated credentials, and blocks the unauthenticated setup wizard. BambooHR's plans start around $10 per employee per month. Horilla on Railway costs about $10–15/month for any number of employees.

---

## What This Template Deploys

| Service | Purpose |
|---|---|
| **Horilla** | Built from the `2.0` branch of Horilla's repository with a Railway boot layer. Django 5.2 and gunicorn on port `8000` with a public domain. Volume at `/app/media` for documents, photos and attachments. |
| **Postgres** | `postgres-ssl:18`, private only. Volume at `/var/lib/postgresql/data` holds every employee, attendance, leave and payroll record. |
| **Redis** | `redis:8.2` with a password, private only. Django's cache. |

On boot the layer fixes volume ownership, runs migrations with retries, creates the administrator once, and sets allowed hosts and secure cookies for your Railway domain.

---

## Important: Scheduled Jobs Do Not Run

Recent Horilla 2.x code runs its scheduled jobs in a separate `run_scheduler` process: automatic payslips, leave resets, attendance work records, auto punch-out, shift rotation, contract expiry and asset or document reminders. This template only starts the web server, so **those jobs never run**. Everything you do by hand works normally.

**What to do:** for now, run payroll, leave and attendance actions manually from the app. If you need automatic jobs, run `python manage.py run_scheduler` as one extra process with the same settings as the web service, as Horilla's own Docker Compose file does, and keep exactly one copy of it so jobs never run twice.

---

## About Hosting Horilla

HR data lives in spreadsheets until a team grows, and then hosted HR suites charge for every employee every month. Horilla gives small and mid-sized companies the main HR modules in one system, on infrastructure you control, at a flat cost.

**Employees.** Profiles, documents, contracts, job history, work types, shifts, departments and an org chart.

**Recruitment.** Job postings, a candidate pipeline with stages, interviews, skill zones and a careers page.

**Onboarding and offboarding.** Checklists and tasks for new hires and leavers, with exit interviews and asset return.

**Attendance.** Check-in and check-out, biometric device integration, overtime, late arrivals and early departures.

**Leave.** Leave types, policies, accruals, balances, holidays and approval workflows.

**Payroll.** Salary structures, allowances, deductions, tax brackets, loans and payslips.

**Performance.** Objectives and key results, 360 feedback, review periods and bonus points.

**Assets and helpdesk.** Assign company assets to employees and run an HR ticket desk.

**Projects and timesheets.** Projects, tasks and time logs per employee.

---

## Deploy Horilla in Under 5 Minutes

1. Click **Deploy on Railway**. The admin password, Django secret and database passwords are generated for you.
2. Wait for Postgres and Redis, then for Horilla's first boot, which runs migrations.
3. Open the public domain and sign in as `admin` with the `HORILLA_ADMIN_PASSWORD` value from the **Variables** tab.
4. Add your company, departments, job positions and work types under **Settings**.
5. Add employees by hand or import them from a spreadsheet, then set up leave types and payroll structures.

---

## Common Use Cases

- **Small businesses:** replace HR spreadsheets with one employee database and self-service.
- **Growing startups:** run hiring pipelines and onboarding without a separate applicant tracking tool.
- **Payroll preparation:** calculate salaries, allowances and deductions and generate payslips.
- **Shift-based teams:** track attendance, shifts and overtime for retail, factories or clinics.
- **Leave management:** handle requests, approvals and balances online.
- **Performance cycles:** run objective-based reviews and 360 feedback.
- **Data residency:** keep salary and personal data on infrastructure you control.

---

## Configuration

| Variable | Required | Default | Description |
|---|---|---|---|
| `HORILLA_ADMIN_USERNAME` | Required | `admin` | First administrator's login |
| `HORILLA_ADMIN_PASSWORD` | 🔐 Auto-generated | 20-char secret | First administrator's password |
| `HORILLA_ADMIN_EMAIL` | Optional | `admin@` your domain | Administrator's employee email |
| `SECRET_KEY` | 🔐 Auto-generated | 50-char secret | Django signing key; keep it stable |
| `DB_INIT_PASSWORD` | 🔐 Auto-generated | 48-char secret | Guards Horilla's demo data loader |
| `DATABASE_URL` | Auto-set | Postgres reference | Database connection |
| `REDIS_URL` | Auto-set | Redis reference | Cache connection |
| `TIME_ZONE` | Optional | `UTC` | Timezone for attendance and payroll |
| `DEBUG` | Optional | `False` | Keep off in production |
| `GUNICORN_WORKERS` | Optional | `1` | Web worker processes |
| `GUNICORN_THREADS` | Optional | `8` | Threads per worker |
| `EXTRA_ALLOWED_HOSTS` | Optional | not set | Extra hostnames for a custom domain |

**Timezone.** Set `TIME_ZONE`, such as `Asia/Kolkata` or `America/New_York`, before you record attendance, so check-ins land on the right day.

**Custom domain.** Add it in Railway, then put the hostname in `EXTRA_ALLOWED_HOSTS` and redeploy.

**Email.** Configure an SMTP mail server in Horilla's settings so leave approvals, interview invites and payslips reach people.

**Languages.** Ten interface languages are compiled into the image; each user can pick one.

**Backups.** Turn on Railway backups for the Postgres volume and copy the media volume too, since it holds employee documents.

**Upgrades.** Each rebuild pulls the latest code on the `2.0` branch. Back up Postgres before redeploying.

**Concurrency.** Keep one gunicorn worker and raise `GUNICORN_THREADS` for more simultaneous users; this keeps memory low on a small team.

**Employee self-service.** Every employee can get a login to view payslips, apply for leave, check in and update their own details. Create user accounts when you add employees, or later from each profile.

**Biometric devices.** Horilla can pull attendance from supported biometric devices; the device must be able to reach your Railway domain or a sync tool you run.

**Demo data.** Horilla's demo loader is protected by `DB_INIT_PASSWORD`. Use it only on a test project, never on your live HR data.

---

## Horilla vs. Alternatives

| Feature | Horilla on Railway | BambooHR | OrangeHRM | Frappe HR |
|---|---|---|---|---|
| Hosting | Self-hosted | Hosted SaaS | Self-hosted | Self-hosted or cloud |
| License | LGPL-2.1 | Proprietary | GPL-3.0 | GPL-3.0 |
| Payroll | ✅ | Add-on | ❌ | ✅ |
| Recruitment | ✅ | ✅ | ✅ | ✅ |
| Attendance and shifts | ✅ | ✅ | ✅ | ✅ |
| Asset tracking | ✅ | ❌ | ❌ | Via ERPNext |
| Price | About $10–15/month flat | From about $10/employee/month | Hosting cost | Hosting cost |

BambooHR is polished but grows expensive with headcount. OrangeHRM is simple but has no payroll. Frappe HR is strong inside ERPNext. Horilla packs the most HR modules into one standalone app.

---

## Dependencies for Horilla Hosting

- A Railway account.
- An SMTP provider for notifications.

### Deployment Dependencies

- [Horilla on GitHub](https://github.com/horilla-opensource/horilla): source code and releases
- [Horilla documentation](https://docs.horilla.com/): user and admin guides
- [horilla-railway](https://github.com/gridalpha/horilla-railway): the Railway build used here

### Implementation Details

The setup-wizard routes that can create superusers are blocked unless you set `HORILLA_ALLOW_SETUP_WIZARD`. Static files and translations are built into the image, and logs go to Railway's log stream.

---

## Frequently Asked Questions

**What is Horilla?**
An LGPL-2.1 open source HRMS for recruitment, attendance, leave, payroll, performance and more.

**How much does it cost to host Horilla?**
About $10–15/month on Railway for Horilla, Postgres and Redis, with no per-employee fees.

**What is the admin login?**
Username `admin` with the `HORILLA_ADMIN_PASSWORD` value from the Variables tab.

**Why aren't payslips or leave resets automatic?**
Scheduled jobs need a separate `run_scheduler` service, which this template does not include.

**Can I import existing employees?**
Yes. Horilla imports employees, leave balances, assets and salary structures from spreadsheets.

**Does Horilla include payroll?**
Yes. It handles salary structures, allowances, deductions, taxes and payslips.

---

## Why Deploy and Host Horilla on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Horilla on Railway, you get a full HR system with payroll, attendance and recruitment on Postgres, without per-employee subscription fees.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/horilla-hr-software
