---
title: "Set up & Installation"
space: "NL Piece Rate Pay"
url: "https://docs.navari.co.ke/nl-piece-rate-pay/set-up-installation"
updated: "2026-06-02"
---

The app requires a working bench with **ERPNext** and **Frappe HR** installed. ERPNext is declared as a hard dependency; Frappe HR is required in practice because the app builds on Salary Structure, Salary Component, Attendance, Shift Type and Salary Structure Assignment, all of which come from Frappe HR / Payroll.

## Steps

```sh
# 1. Prerequisites: bench, ERPNext, and Frappe HR already installed

# 2. Fetch the app into your bench
bench get-app https://github.com/navariltd/nl-piece-rate-pay.git

#    To pull a specific branch (e.g. version-15):
bench get-app https://github.com/navariltd/nl-piece-rate-pay.git --branch version-15

# 3. Install it on your site
# Replace {sitename} with your site name.
bench --site {sitename} install-app nl_piece_rate_pay

```



## Branches and requirements

- **Available branches:** `develop` (default) and `version-15`. Match the branch to your ERPNext/Frappe HR major version then use `version-15` for an ERPNext v15 stack.
- **Python:** ≥ 3.10.
- **License:** GNU AGPL v3.0.

## What gets installed

On install the app registers its own module and ships a few additions to the Desk and to standard doctypes automatically and also a custom field on Salary Structure Assignment, a button on Activity Type, and a dedicated workspace.