
Deploy Frappe HR
Open-source HR and payroll (HRMS on ERPNext v16), full stack, no prompts
Redis-Cache
Just deployed
Websocket
Just deployed
MariaDB
Just deployed
/var/lib/mysql
Scheduler
Just deployed
Frappe-HR
Just deployed
/home/frappe/frappe-bench/sites
Redis-Queue
Just deployed
/data
Deploy and Host Frappe HR on Railway
Frappe HR (HRMS) is open-source HR and payroll software built on ERPNext by Frappe. It covers the whole employee lifecycle: onboarding, attendance and shift tracking, leave, expense claims, appraisals, recruitment and payroll with salary slips and tax rules, plus a mobile-friendly employee self-service app. It is GPL-3.0 with no per-employee fees.
About Hosting Frappe HR
Frappe HR is an app on the Frappe framework and needs ERPNext installed alongside it. Frappe runs several processes from the same code: the gunicorn backend, nginx for assets and file downloads, a Node.js socket.io server for live updates, background workers and a scheduler that runs attendance, leave and payroll jobs. It also needs MariaDB with utf8mb4 settings and Redis for both the cache and the job queue. The backend and workers share a sites folder holding the site config, encryption key and attachments. A Railway volume attaches to one service only, so those two share the Frappe HR service, while the realtime server, scheduler, database and both Redis instances run as separate services on the private network.
Common Use Cases
- Employee records, onboarding and exits, with an org chart and a profile page for each employee
- Leave, attendance, shifts and holiday lists, with approvals in the web and mobile self-service app
- Payroll: salary structures, salary slips, tax and benefit components, and expense claims
Dependencies for Frappe HR Hosting
- MariaDB 11.8 (database, with Frappe's utf8mb4 settings)
- Redis 8.2, twice: one for the cache, one for the job queue and realtime events
Deployment Dependencies
- Frappe HR v16.60.0 release
- Official frappe/erpnext image (Frappe v16.60.2, ERPNext v16.60.0)
- frappe_docker, the upstream container setup
- Template repository with the Dockerfiles and start scripts
Implementation Details
The template deploys six services. Frappe HR, Websocket and Scheduler build from the template repository, FROM frappe/erpnext:v16.60.0 pinned by digest, with Frappe HR installed from its v16.60.0 release tag.
- Frappe HR (public URL): nginx, gunicorn and a background worker for the long, default and short queues. Its volume holds the
sitesfolder. On first start it creates the site with ERPNext and Frappe HR and theAdministratoruser. When an update changes the app versions, it runsbench migrate. - Websocket: Frappe's socket.io server. Nginx forwards
/socket.ioto it over the private network. - Scheduler: runs
bench schedule, which queues attendance, leave allocation, payroll reminders and other periodic jobs. - MariaDB:
mariadb:11.8.9, pinned by digest, with a volume. - Redis-Cache:
redis:8.2.6, held in memory only (256 MB, least recently used keys are evicted first). - Redis-Queue:
redis:8.2.6with append-only persistence on a volume.
All passwords are generated at deploy time, and the deploy form asks for nothing. The first start takes about 5 to 8 minutes, and a "Frappe HR is starting" page shows until it finishes. Then open the public URL, sign in as Administrator with the ADMIN_PASSWORD value from the Frappe HR service's Variables tab, and complete the setup wizard (company, country, currency, fiscal year). Change the Administrator password afterwards. Employees use the self-service app at /hrms. To send emails (leave approvals, salary slips), add an email account in the desk; SMTP isn't included. Updates come as Railway "update available" notices when the template repository bumps the version. Back up the MariaDB and Frappe HR volumes before you apply one.
Why Deploy Frappe HR 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 Frappe HR 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
Redis-Cache
redis:8.2.6Websocket
aalfath/frappe-hr-railway-templateMariaDB
mariadb:11.8.9Scheduler
aalfath/frappe-hr-railway-templateFrappe-HR
aalfath/frappe-hr-railway-templateRedis-Queue
redis:8.2.6