Easy POS Docs - Installation & Setup

Easy POS is a standard Frappe app — no external services or databases to stand up.

Requirements

• A Frappe bench (Frappe Framework v15+)
• ERPNext installed on the target site (Easy POS reuses ERPNext's Sales Invoice, Customer, and POS Profile doctypes)
• Frappe's payments app installed if you plan to use a live payment gateway (e.g. Razorpay)

Install the app

cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/aashishvashisht6/EasyPOS --branch develop
bench install-app easy_pos

First-time configuration

1. Create a POS Profile (or reuse an existing one) under ERPNext's POS Profile list, and add the payment modes your till accepts under its Payments table.
2. Assign the POS Profile to the users/roles who will run the till.
3. Sign in at /posapp with your workstation credentials and open your first shift — see Quick Start.

Frontend development (for contributors)

cd posapp
yarn install
yarn dev      # start the Vite dev server
yarn build    # production build; also copies the built HTML into the Frappe app