Question 1

Is KinetiRx really free pharmacy management software?

Accepted Answer

Yes — KinetiRx has no monthly per-shop software subscription. It's free pharmacy management software in the sense that matters day to day: no license fee, no per-user charge, no feature paywall. It is self-hosted, so you provide the computer, NAS, or VPS and cover any infrastructure cost yourself. The source is visible on GitHub, but it currently has no open-source license; contact the maintainer for reuse or redistribution.

Question 2

Who is KinetiRx for?

Accepted Answer

Independent pharmacies and small clinics that want a real system of record — billing, stock, patients, dues — instead of a spreadsheet, and are comfortable self-hosting or have someone who can help deploy it, rather than paying a SaaS vendor a monthly per-shop fee.

Question 3

Can I use it without AI invoice scanning?

Accepted Answer

Yes. Manual inward entry is available for every purchase bill. Inward OCR is optional and requires a Gemini API key you configure yourself — without one, the rest of KinetiRx, including billing, inventory, due-khata, and patient records, works exactly the same.

Question 4

What is due-khata, exactly?

Accepted Answer

Udhaar or “khata” is the informal running-credit tab many Indian shops and pharmacies keep for trusted regular customers — they take medicine now and settle up later, sometimes in parts. Due-Khata is that same ledger digitized: every due amount, every partial payment, and the full history against a customer, instead of a paper notebook only the counter staff can read.

Question 5

Does the AI invoice scanning require an internet connection?

Accepted Answer

The core system — POS, inventory, patients, due-khata, everything — runs entirely on your own Postgres database with no cloud dependency. Inward OCR (the AI purchase-bill scanner) is the one optional exception: it uses Google Gemini and needs an API key you supply. Without a key configured, that one feature falls back to a manual entry form — the rest of the app is unaffected.

Question 6

What hardware do I need to self-host it?

Accepted Answer

Anything that runs Docker: a spare PC, a home NAS, or a small VPS. The stack is three containers — PostgreSQL, the Go backend, and an nginx-served React frontend — started with a single docker compose command.

Question 7

How do I install it?

Accepted Answer

Clone the repository, copy deploy/.env.example to deploy/.env, fill in a Postgres password, a JWT secret, and an admin password, then run docker compose up. The app opens on the port you configured, and the first login uses the admin credentials you just set.

Question 8

Can I install it on CasaOS?

Accepted Answer

A CasaOS App Store manifest (x-casaos v2) is included in the repository and ready to submit. It isn't published to the CasaOS App Store yet — once it is, installing will be a single click from the CasaOS UI. Until then, Docker Compose works on any CasaOS box today.

Question 9

Does it handle GST billing correctly?

Accepted Answer

Yes — POS checkout produces a proper GST invoice, and Invoice Settings lets you store your GST and drug-license numbers, invoice numbering scheme, and letterhead so every bill is correctly formatted from the first sale.

Question 10

Can I use it with Claude or another AI assistant?

Accepted Answer

Yes. An included MCP server (run via a Docker Compose profile) lets Claude Desktop or Claude Code look up inventory, check a patient's due-khata balance, pull the daily register, or record a sale — using the permissions of whichever employee credentials it's configured with.

Feature	KinetiRx	Typical hosted pharmacy SaaS	Spreadsheet
Ongoing cost	Your server only	Monthly subscription	Free
Data stays on your server
GST-compliant POS billing
Batch/expiry inventory		Paid add-on	Manual
Due-khata credit ledger		Rare	Manual
Patient records & OPD		Paid tier
AI invoice OCR	Optional (Gemini)	Rare
Role-based staff accounts
No vendor lock-in

Run billing, inventory, and customer dues in one free pharmacy management system.

Built for the work behind an independent pharmacy counter.

From an incoming bill to a clean close of day.

Receive stock

Bill at the counter

Keep records current

Close with confidence

Receive stock

Bill at the counter

Keep records current

Close with confidence

Clear screens for the work you do most.

Start every day with the pharmacy dashboard

Create a GST bill while serving a customer

Catch inventory issues before the shelf is empty

Find a patient’s history without digging through paper

Make due-khata searchable and auditable

One system for pharmacy operations—not a spreadsheet with more tabs.

Bill accurately at the counter

Protect stock value

Manage customer credit

Keep patient context together

Finish the day cleanly

Give staff only the access they need

Turn purchase bills into reviewable stock entries.

Your pharmacy data stays on infrastructure you control.

No recurring per-shop SaaS fee

Your database

Works locally

Your upgrade schedule

Download KinetiRx and start on your own server.

Get the code

Set initial admin & database secrets

Start the stack

Clone the repository

Configure secrets

Start the stack

Why choose KinetiRx instead of a spreadsheet or hosted subscription?

Common questions

Ready to replace scattered pharmacy records with one system?