How to Install a Receipt Printer for Your POS in Kenya (Step-by-Step)

A receipt printer is not a gadget. It is the last handshake of the sale — the scrap of paper a customer folds into a pocket while they still trust you. Installing one on a Kenyan POS should feel like hiring a quiet extra cashier, not surviving a Windows wizard.

This guide is the complete path: pick the right thermal printer, load the paper the right way round, add it to Windows, macOS, or Linux, connect it in Kiosk Cashier, and print a real slip. Plan on about 15 minutes — provided the cable in the box is the data cable. Many shops lose half an hour to a phone charger that only powers the lights.

What you need (and what you can skip)

58mm or 80mm? Match the printer to the queue

Both widths are thermal, and both speak ESC/POS. If you are unsure, walk into the shop and say “POS printer” — then buy the spare rolls at the same time. Paper is pennies; running out mid-queue is the only paper mistake that costs sales.

Step 1 — Pick a thermal printer and plug it in

Buy the printer and the spare rolls in the same trip. At the counter, ask for a thermal POS printer in your width, and check the box has the square USB-B data cable and a power adapter — some units ship with a charger-only lead that will cost you an afternoon. Inkjet and laser belong in an office, not beside the mango crate.

• USB — one till, one cable. Start here.
• Bluetooth — the till is a tablet that walks the aisle.
• Ethernet / Wi-Fi — several tills share one printer on the LAN (raw port 9100).

Before you close the lid, get the paper the right way round. The shiny, thermal-coated side must face the print head — a roll loaded backwards prints blank grey slips and has sent more “broken” printers back to the shop than any real fault. Not sure which side is shiny? Scratch the paper hard with a fingernail: the side that greys is the one that prints.

Step 2 — Add the printer in Windows

Most Kenyan tills are Windows 10 or 11. Plug USB in, switch the printer on, then open Settings → Bluetooth & devices → Printers & scanners. Detect only reads that list. Skip Microsoft Print to PDF and Fax — those are ghosts, not tills.

If Printers & scanners is empty of a real thermal name, hire the printer by hand. Windows will not find many Xprinters on its own:

• Printers & scanners → Add a printer → The printer that I want isn’t listed.
• Add a local printer. Port: USB001, or the COM port Device Manager showed.
• Driver: Generic / Text Only. Name it Xprinter. Set it Online.
• Only then go back to Cashier and Detect. Until that name sits under Printers & scanners, Detect cannot see it.

• Printer ON, lid closed, paper seated shiny-side to the head.
• Data USB cable into the till PC — not a charger-only lead.
• Windows 7 tills use the separate Kiosk Windows 7 Print Bridge package, still downloaded from Cashier.

Step 3 — Add the printer on macOS

On a Mac till: System Settings → Printers & Scanners → Add Printer. Keep the factory name so Detect can read it. Choose a generic ESC/POS or the maker's thermal driver. AirPrint is for office documents — it will not cut a 58mm slip.

Step 4 — Add the printer on Linux

Linux tills speak CUPS. Install cups if needed, add a raw ESC/POS queue (localhost:631 or your desktop Printers app), confirm lpstat shows the printer idle, then run the Kiosk Linux installer. Detect in Cashier is the same button as on Windows — the OS changes, the habit does not.

Step 5 — Open Cashier and download the bridge

The Print Bridge is not an app you hunt in Settings, on the Desktop, or in a WhatsApp zip from last month. It is a till tool. It lives on the Cashier page — the same screen you sell from — behind the quiet chip. Open Cashier on this computer (the one with the printer plugged in). Tap Receipts on screen. Tap Connect a printer. Download from that chip. That is the only doorway we keep.

Step 6 — Detect printers and save the queue

Unzip the package. Windows 10/11: run Install-Palmart-Print-Bridge.cmd (no Node.js needed; it can start hidden at sign-in). Windows 7: the Win7 installer. macOS: Install Palmart Print Bridge.command. Linux: bash install-palmart-print-bridge.sh. Then click Detect printers.

• Choose the row marked (receipt). Skip Fax and PDF.
• If you manage the shop, Detect can save the name onto the branch so every cashier on that till inherits it.
• You can also set the printer under Branches → Receipt details, then Save.

Step 7 — Print a test receipt

The chip should now show the printer name, not Receipts on screen. Ring a cheap test item, complete the sale, and watch the paper feed and cut. Shop name, M-Pesa till, and footer come from Branches → Receipt details — fix the wording there, not on the printer.

Wondering what each line on the slip is, or where to change it? Every line has exactly one source:

When nothing comes out

Work down the flow below and stop at the first row that fails. Then read the Detect toast — it tells you which room is empty.

Which Detect toast do you get?

Tap Detect printers once. The toast is the diagnosis. Do not keep tapping.

The 15-minute version

• Thermal printer ON, paper seated shiny-side to the head, data cable in the till PC.
• Self-test with FEED + power. Confirm a real name under Printers & scanners — not only Device Manager. Skip PDF and Fax.
• Cashier on this PC → Receipts on screen → Connect a printer → download the helper from that chip.
• Run Install-Palmart-Print-Bridge.cmd once on this computer. Confirm http://127.0.0.1:19500/health.
• Detect printers. Read the toast. Empty queues: add Generic / Text Only as Xprinter, then Detect again.
• One test sale. Paper in the customer's hand.

Bottom line

Read next:

• Install a receipt printer (Help Center)The same walkthrough inside Help — for cashiers at the till.→
• What Hardware Do You Actually Need?Phone first, scanner second, printer third.→
• Set Up a POS in Kenya in 30 MinutesSoftware live the same afternoon — hardware optional.→
• Print or share receiptsPaper, screen, or WhatsApp after checkout.→