Deploy Frappe HR

Open-source HR and payroll (HRMS on ERPNext v16), full stack, no prompts

Deploy Frappe HR

Redis-Cache

redis:8.2.6

Just deployed

Just deployed

/var/lib/mysql

/home/frappe/frappe-bench/sites

Redis-Queue

redis:8.2.6

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

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 sites folder. On first start it creates the site with ERPNext and Frappe HR and the Administrator user. When an update changes the app versions, it runs bench migrate.
  • Websocket: Frappe's socket.io server. Nginx forwards /socket.io to 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.6 with 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

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
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0