Home

nodedr-pos wiki

nodedr-pos is a free, open-source (AGPL-3.0), offline-first Point of Sale and inventory management system for small retail shops. It runs as a two-container Docker Compose stack (or a native Windows/Debian install) on a machine in the shop — no internet connection required after setup, no subscription, no data ever leaving the premises.

Built around a barcode-scanner counter workflow: scan an item to sell it, press Enter to check out, print or download the receipt with one click. No scanner handy? Scan from a phone/tablet camera instead. No barcode at all? Generate and print one, right from the app.

The README is the authoritative reference — it's kept in lockstep with the code. This wiki is a navigable companion: shorter pages, task-oriented, for when you don't want to scroll one long document.

Get started

I want to...	Go to
Install it (Docker, Windows, Debian, or CasaOS/ZimaOS)	Installation
See what it does before installing	Features
Understand how the pieces fit together	Architecture
Set up a barcode scanner, camera scanning, or a receipt printer	Hardware Setup
Fix a specific problem (camera not working, printer not detected, dues not clearing, etc.)	Troubleshooting
Call the backend directly / build an integration	API Reference
See what's built vs. still planned	Roadmap
Report a bug or send a PR	Contributing

At a glance

• License: AGPL-3.0 — see LICENSE
• Access it at: http://<machine>:1994 — from the shop's own machine or any tablet/phone on the same network
• Stack: Next.js/React frontend, Express + Prisma (SQLite) backend, both behind a single exposed port
• Install paths: Docker Compose (any OS), native .exe installer (Windows 10/11), native .deb package (Debian/Ubuntu), or a CasaOS/ZimaOS one-click app
• Core features: GST-inclusive pricing with CGST/SGST breakout, per-item and order-level discounts, loyalty points, customer dues ("udhaar"), returns/exchanges with store credit, multi-currency, barcode/QR generation, three ways to print (browser dialog, PDF download, direct USB ESC/POS), and a sales dashboard with charts
• Repo: Raktim94/nodedr-pos
• Live marketing site: pos.nodedr.com

Philosophy

This is a small, focused tool for one shop, one till — offline-first, zero-cloud, zero-subscription. Feature requests and contributions are welcome, but scope stays aligned with that: see Contributing before proposing anything that pushes toward multi-tenant or hosted-SaaS territory.