NodeDR POS Documentation

NodeDR POS

Free, open-source, offline-first Point of Sale for small retail shops. One Docker install, no subscription, no data ever leaves the store.

MIT LicenseDockerNext.jsSQLiteESC/POSGST-ready

What is NodeDR POS?

NodeDR POS is a complete Point of Sale system designed for small retail shops — kiranas, pharmacies, clothing stores, electronics shops, and any counter-based business. It runs as a two-container Docker stack on a local machine and is accessible from any device on your shop’s network. Once installed, it works with no internet connection and makes zero outbound calls — your sales data never leaves the building.

Quick orientation

If this is your first time, follow these three steps:

1. Install NodeDR POS — one command, under 10 minutes.
2. Set up your hardware — barcode scanner and thermal printer.
3. Make your first sale — scan items, select payment, print receipt.

Key capabilities

• Barcode-driven checkout — scan to add, Enter to finalize. Unknown barcodes surface a toast, not a crash.
• GST billing — MRP-inclusive tax with CGST/SGST breakdown, GSTIN on receipt, per-product HSN/SAC codes.
• Three receipt modes — browser print dialog, server-side PDF download, or direct ESC/POS over USB to a thermal printer.
• Loyalty program — points earned per purchase, redeemable at checkout.
• Customer dues (udhaar) — sell on credit, track balances, record repayments.
• Returns & exchanges — look up any past invoice from the register, return items, net against a new sale.
• Multi-currency — 20+ major currencies, switchable in Settings.
• Staff roles — admin and cashier with scoped permissions.
• LAN access — any tablet or phone on the same network can open the register.

Browse the documentation

Architecture at a glance

Browser / LAN tablet
      │  http://<machine>:1994   ← only exposed port
      ▼
┌─────────────────┐  /api/*  ┌──────────────────┐
│  Next.js :1994  │ ───────▶ │  Express :4000   │
│  (frontend)     │ ◀─────── │  + Prisma + SQLite│
└─────────────────┘  internal└──────────────────┘
                              data → Docker volume

The frontend is the only container exposed on your network. The backend lives entirely on the internal Docker network — it is not reachable from the LAN. All session cookies are first-party and HttpOnly.

License & attribution

NodeDR POS is released under the MIT License. It is free to use, fork, modify, and redistribute — including for commercial use. Built and maintained by NODEDR INFOTECH PRIVATE LIMITED.