Deploy Horilla

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

Deploy Horilla

/var/lib/postgresql/data

Just deployed

/app/media

Just deployed

/data

Deploy and Host Horilla on Railway

Horilla logo

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

ServicePurpose
HorillaBuilt 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.
Postgrespostgres-ssl:18, private only. Volume at /var/lib/postgresql/data holds every employee, attendance, leave and payroll record.
Redisredis: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

VariableRequiredDefaultDescription
HORILLA_ADMIN_USERNAMERequiredadminFirst administrator's login
HORILLA_ADMIN_PASSWORD🔐 Auto-generated20-char secretFirst administrator's password
HORILLA_ADMIN_EMAILOptionaladmin@ your domainAdministrator's employee email
SECRET_KEY🔐 Auto-generated50-char secretDjango signing key; keep it stable
DB_INIT_PASSWORD🔐 Auto-generated48-char secretGuards Horilla's demo data loader
DATABASE_URLAuto-setPostgres referenceDatabase connection
REDIS_URLAuto-setRedis referenceCache connection
TIME_ZONEOptionalUTCTimezone for attendance and payroll
DEBUGOptionalFalseKeep off in production
GUNICORN_WORKERSOptional1Web worker processes
GUNICORN_THREADSOptional8Threads per worker
EXTRA_ALLOWED_HOSTSOptionalnot setExtra 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

FeatureHorilla on RailwayBambooHROrangeHRMFrappe HR
HostingSelf-hostedHosted SaaSSelf-hostedSelf-hosted or cloud
LicenseLGPL-2.1ProprietaryGPL-3.0GPL-3.0
Payroll✅Add-on❌✅
Recruitment✅✅✅✅
Attendance and shifts✅✅✅✅
Asset tracking✅❌❌Via ERPNext
PriceAbout $10–15/month flatFrom about $10/employee/monthHosting costHosting 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

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.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
Letta Code Remote
Run a Letta Code agent 24/7. No inbound ports, just deploy.

Letta
52