Quick answer: Erply does not send ESC/POS to your printer directly, and it does not use OPOS or JavaPOS either. It runs a local printing microservice — Erply's documentation calls it the Golang Printing Microservices, installed by the Erply Installer2 service — which prints through the printer you have installed in Windows.
So the specification is simple: a printer with a solid Windows driver, on USB or LAN. The NBTP-8080 (80mm, auto cutter, USB + LAN) fits. And when something goes wrong, look at the microservice status indicator in the top right of the POS before you look at the printer — green means running, red means nothing will print no matter what you change.
The architecture, and why it decides what you buy
Most POS systems fall into one of two camps: they open a port and write ESC/POS bytes, or they print through the operating system. Erply does something slightly unusual — it installs a local service to do the job.
Erply's own troubleshooting documentation describes two printing pathways: microservices-based printing as the primary route, and browser-based printing as a fallback. The POS says the system allows for either microservices or browser-based printing.
What this means when you are choosing hardware:
- The printer must work in Windows first. Erply's troubleshooting sequence checks Control Panel → Devices and Printers and a Print Test Page before anything else. If Windows cannot print to it, Erply cannot either.
- A driver is required. Driver installation is an explicit step in their checks.
- Brand is not a technical gate — the microservice prints to a Windows printer, and a Windows printer is a Windows printer. But see the honest caveat below about Erply's tested list.
The status indicator is the first thing to check
This is the single most useful thing to know about running Erply, and it saves an hour the first time.
Erply shows a Microservices status indicator in the upper right corner of the POS interface. Green means the service is running. Red means it is not.
If that indicator is red, no amount of printer configuration will produce a receipt — the component that does the printing is not running. The fix is on the service side (is Erply Installer2 running? was it blocked at startup? did an update leave it stopped?), not on the hardware side.
We mention this in a hardware guide because of how the failure presents: a shop reports “the new printer does not work” on day one, the printer gets returned, and the replacement does not work either. Check the colour of the dot first.
Registering the printer: the Vendor Name field
Erply's integration setup asks for two things about the printer, and both must be right.
Within the Microservices settings — reached through the Hardware section → Integration → POS tab — Erply verifies that the printer's name is listed under the Name field and that the manufacturer or brand name is displayed under Vendor Name.
Two practical consequences:
-
The Name must match the Windows printer name exactly. This is the same class of trap as KORONA's name matching: a duplicate Windows installation ending in
(2)means the POS is addressing a printer that no longer has hardware behind it. - Vendor Name comes from the driver, not from the box the printer arrived in. If you install a printer using a generic driver, the vendor string may not be what you expect. Worth checking during commissioning rather than during a Saturday rush.
Browser printing as the fallback
Erply's second pathway is browser printing, and it is worth knowing it exists because the failure modes are different.
Browser printing goes through the print dialog, which means page setup matters: margins, paper size, and headers and footers all affect the result — the same set of issues we cover in the Hike guide, where browser printing is the only route. If receipts suddenly come out with wide margins or stop cutting, one possibility is that the system has fallen back to browser printing.
About Erply's tested printer list
We would rather say this up front than have you find out after ordering.
Erply's hardware documentation lists specific tested models — Star Micronics (mC-Print2, TSP100III, TSP650, SM-L300), Epson (TM-T20III, TM-m30, TM-m30III, TM-m10, TM-T88IV), Citizen CT-S651, Diebold Nixdorf TH250, Partner Tech RP-330. NETBYE printers are not on that list. No Chinese-brand printer is.
What that does and does not mean:
- The architecture does not check brands. The microservice prints to an installed Windows printer. That is a technical statement about how it works, not a promise about your specific installation.
- We have not tested our models against Erply, and we will not claim compatibility we have not verified. Our printers are standard ESC/POS with Windows drivers in USB and LAN variants — the profile this architecture expects — which is a reasoned expectation, not a test result.
- Ask for a sample before a volume order. If you are specifying Erply tills at scale, tell us and we will send a unit to validate against your actual installation first. It costs you nothing and it is the only honest way to close this gap.
80mm or 58mm?
80mm at 203dpi gives 48 characters per line — the right default for retail, and the width Erply's tested models mostly are. 58mm gives 32 characters, which suits queue tickets and short dockets but crowds an itemised receipt with tax lines.
NETBYE models for Erply
| Model | Paper | Speed | Cutter | Interfaces | Best for |
|---|---|---|---|---|---|
| NBTP-8080 | 80mm | 160mm/s | Auto | USB / USB+LAN | Standard counter — the default |
| NBTP-8050 | 80mm | 200mm/s | Auto | USB / Serial / Ethernet | Busier checkout |
| NBTP-8020 | 80mm | 180–200mm/s | Auto | USB / USB+LAN | Standard counter, budget |
| NBTP-5880 | 58mm | 90mm/s | Manual | USB / Serial / Ethernet | Queue tickets, short dockets |
All 203dpi direct thermal with ESC/POS — 576 dots per line on the 80mm models (72mm print width), 384 on the 58mm (48mm). Browse the full range of thermal receipt printers or narrow to 80mm.
Ordering advice for Erply: USB is fine for a single till and is the simplest thing to register in Windows. Choose LAN if the printer must be shared or sits away from the PC. Confirm an RJ11 drawer port if a cash drawer is in scope, and note that Erply's documented drawer setup assumes 24V — see the Erply cash drawer guide before ordering drawers.
Frequently asked questions
Which receipt printers work with Erply POS?
Technically, any printer that works as an installed Windows printer, because Erply prints through a local microservice rather than by sending ESC/POS directly. Erply separately publishes a list of models it has tested.
Does Erply use OPOS or JavaPOS?
No. Erply's hardware documentation describes a microservice architecture for hardware communication rather than those standards. You do not need an OPOS driver to use a printer with Erply.
Nothing prints and there are no errors.
Check the Microservices status indicator in the top right of the POS. If it is red, the printing service is not running and nothing else matters. If it is green, print a Windows test page next.
Where do I register the printer?
Hardware section → Integration → POS tab, in the Microservices settings. Check that the printer name and the Vendor Name are both shown correctly.
My receipts suddenly have huge margins.
One possibility is that printing has fallen back to the browser pathway, where page setup governs the output. Check the microservice status, then the print dialog settings.
Do I need a driver?
Yes. Driver installation is an explicit step in Erply's own troubleshooting sequence, and the printer must print from Windows before Erply can use it.
A note on this guide. The printer side above — ESC/POS, interfaces, print widths, driver behaviour, duplicate-installation symptoms — is what we know from the products we supply. The Erply-specific parts, including the printing microservice, the Erply Installer2 service, the status indicator, the Name and Vendor Name fields and the browser-printing fallback, are drawn from Erply's published wiki. We have not tested our printers against Erply ourselves, and we have not claimed we have. Menus and tested models change between releases, so confirm current details with Erply. If something here did not match your installation, tell us and we will correct this page. We would rather publish something accurate than something impressive.
Get pricing
NETBYE supplies distributors, system integrators and retailers worldwide. Our printers are built by our partner factories in Shenzhen and sold under our own model range — we handle specification, quality control and support, so you deal with one supplier rather than several factories. Direct wholesale pricing, low MOQ on first orders, and OEM/ODM covering branding, packaging and firmware defaults.
Tell us how many tills, USB or LAN, what quantity and which country, and you will get an accurate quote in one reply. For an Erply rollout we will send a sample to validate against your actual installation before you commit to volume. Request a quote.
Related guides
These guides form a set. If you are specifying a complete till, the other hardware for Erply POS is covered here:
- Barcode scanner for Erply POS
- Cash drawer for Erply POS
- Label printer for Erply POS
- POS terminal for Erply POS
And if you are comparing across POS software, the same hardware for other systems: