---
title: "Deploy Frappe HR"
description: "Open-source HR and payroll (HRMS on ERPNext v16), full stack, no prompts"
category: "Other"
url: https://railway.com/deploy/frappe-hr-1
---

# Deploy Frappe HR

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

**[Deploy Frappe HR on Railway](https://railway.com/template/frappe-hr-1)**

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

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

## Template content

### Redis-Cache https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/redis.png

- **Image:** redis:8.2.6@sha256:3055dc25265b0c19ec90a1756dad4e0faff6f79e2557a6ac3d1274e39ee906f6
- **Start command:** `/bin/sh -c 'exec docker-entrypoint.sh redis-server --requirepass "$REDIS_PASSWORD" --save "" --appendonly no --maxmemory 256mb --maxmemory-policy allkeys-lru'`

### Websocket https://raw.githubusercontent.com/frappe/hrms/v16.60.0/hrms/public/images/frappe-hr-logo.png

- **Source:** https://github.com/aalfath/frappe-hr-railway-template

### MariaDB https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mariadb.png

- **Image:** mariadb:11.8.9@sha256:d36f18d65a0459510b8b0f643b226a6d299e3206486e2b64ff20754a6d291707
- **Start command:** `/bin/sh -c 'rm -rf /var/lib/mysql/lost+found; export MARIADB_AUTO_UPGRADE=1; exec docker-entrypoint.sh mariadbd --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --skip-character-set-client-handshake --innodb-snapshot-isolation=OFF'`

### Scheduler https://raw.githubusercontent.com/frappe/hrms/v16.60.0/hrms/public/images/frappe-hr-logo.png

- **Source:** https://github.com/aalfath/frappe-hr-railway-template

### Frappe-HR https://raw.githubusercontent.com/frappe/hrms/v16.60.0/hrms/public/images/frappe-hr-logo.png

- **Source:** https://github.com/aalfath/frappe-hr-railway-template
- **Health check:** /api/method/ping
- **Public domain:** Yes

### Redis-Queue https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/redis.png

- **Image:** redis:8.2.6@sha256:3055dc25265b0c19ec90a1756dad4e0faff6f79e2557a6ac3d1274e39ee906f6
- **Start command:** `/bin/sh -c 'rm -rf /data/lost+found; exec docker-entrypoint.sh redis-server --requirepass "$REDIS_PASSWORD" --appendonly yes --dir /data'`

## Documentation

# 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](https://github.com/frappe/hrms/releases/tag/v16.60.0)
* [Official frappe/erpnext image (Frappe v16.60.2, ERPNext v16.60.0)](https://hub.docker.com/r/frappe/erpnext)
* [frappe_docker, the upstream container setup](https://github.com/frappe/frappe_docker)
* [Template repository with the Dockerfiles and start scripts](https://github.com/aalfath/frappe-hr-railway-template)

### 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.



## 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/frappe-hr-1
