---
title: "Deploy Horilla"
description: "Self-hosted open-source HR: attendance, leave, payroll, recruitment"
category: "Other"
url: https://railway.com/deploy/horilla-1
---

# Deploy Horilla

Self-hosted open-source HR: attendance, leave, payroll, recruitment

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

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

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Horilla https://raw.githubusercontent.com/horilla/horilla-hr/2.4.0/static/images/ui/horilla-sticker-round.png

- **Source:** https://github.com/aalfath/horilla-railway-template
- **Health check:** /health/
- **Public domain:** Yes

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

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

### 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 is free, open-source HR software (LGPL-2.1) for running a company's people operations in one web app: employee records, attendance, leave, payroll, recruitment, onboarding, performance reviews, assets and a helpdesk. It is a Django application backed by PostgreSQL. This template deploys the official Horilla HR 2.4.0 release.

## About Hosting Horilla

Hosting Horilla means running its Django web app with a PostgreSQL database, a Redis cache, a persistent folder for uploaded files, and its background scheduler, which runs the timed jobs for leave, attendance and payroll. This template builds Horilla from the official `horilla/horilla-hr:2.4.0` image, pinned by digest, and runs gunicorn and the scheduler in one service. Production mode is on, the secret key and setup password are generated, and allowed hosts and CSRF origins come from the Railway domain. The first start applies about 370 migrations, which takes 4 to 6 minutes. A "Horilla is starting" page answers in the meantime.

## Common Use Cases

* Keep employee records, departments, job positions and documents in one self-hosted system
* Track attendance, shifts, leave requests and approvals
* Run payroll, recruitment pipelines, onboarding, performance reviews and asset tracking

## Dependencies for Horilla Hosting

* PostgreSQL (Railway Postgres, included)
* Redis (Railway Redis, included)

### Deployment Dependencies

* Horilla HR source and documentation: https://github.com/horilla/horilla-hr
* Template repository (Dockerfile, start scripts, changelog): https://github.com/aalfath/horilla-railway-template

### Implementation Details

There are no prompts: every variable is filled in at deploy. After the deploy turns green and the start-up page is gone:

1. Open the public URL and click **Initialize Database** on the login page.
2. Enter the value of `DB_INIT_PASSWORD` (Horilla service, Variables tab).
3. Create the admin user, then your company, a department and a job position. The setup page closes once the admin exists. To try Horilla first, choose **Load demo data** with the same password instead.

Uploads are stored on a volume at `/app/media`. All other data is in Postgres. Keep the Horilla service at one replica, because the scheduler runs once per replica. For a custom domain, add it to an `ALLOWED_HOSTS` variable (comma-separated). Set up email inside Horilla under Settings, Mail Server.

Updates: the service builds from the template's GitHub repo. When a new Horilla release is pinned there, Railway shows an "update available" notice on your service and you choose when to apply it. Read `CHANGELOG.md` and back up Postgres first. Migrations run on the next start.

## Why Deploy 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 are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## 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)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

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