
Deploy Horilla
Self-hosted open-source HR: attendance, leave, payroll, recruitment
Just deployed
/app/media
Just deployed
/var/lib/postgresql/data
Redis
Just deployed
/data
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:
- Open the public URL and click Initialize Database on the login page.
- Enter the value of
DB_INIT_PASSWORD(Horilla service, Variables tab). - 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.
Template Content
