How to Install ESC/POS Receipt Printing for Web-Based POS Systems

Most thermal receipt printers use ESC/POS technology. While these printers work easily with Windows applications, web-based POS systems require additional configuration because browsers cannot directly send raw ESC/POS commands to printers.

This guide explains how to properly configure receipt printing for a web-based POS system.

Why Web Browsers Cannot Print Directly to Receipt Printers

Web browsers such as:

• Google Chrome

• Microsoft Edge

• Mozilla Firefox

are designed to print formatted documents (like A4 or Letter size).

They do not natively support:

• Raw ESC/POS commands

• Automatic silent printing

• Cash drawer kick commands

Because of this, web-based POS systems require one of the solutions below.

Method 1: Browser Print (Basic Setup – Not Recommended for High-Speed POS)

This is the simplest method but not ideal for retail environments.

How It Works

The POS generates a receipt layout in the browser. The user manually prints using Ctrl + P.

Setup Steps

1. Install the printer driver normally in Windows.

2. Set the receipt printer as default.

3. Open your POS in Chrome or Edge.

4. Press Ctrl + P.

5. Select the receipt printer.

6. Change paper size to:

   • 80mm (most common)

   • 58mm (if applicable)

7. Set margins to “None.”

8. Disable headers and footers.

9. Click Print.

Limitations

• Manual printing required.

• Print dialog appears every time.

• Cannot auto-open cash drawer.

• Slower checkout process.

This method is acceptable for very small businesses but not recommended for high-volume environments.

Method 2: Local Print Service (Recommended for Professional POS)

This is the professional and scalable solution.

A local print service runs in the background on the computer and listens for print jobs from the POS system.

When a sale is completed:

• The POS sends receipt data to the local service.

• The local service converts it to ESC/POS.

• The printer prints instantly.

• The cash drawer opens automatically.

How It Works

1. Printer installed on Windows.

2. Background print service running.

3. POS sends data to the local service.

4. Service sends raw commands to printer.

Requirements

• ESC/POS compatible printer (example: Sewoo, Epson, Xprinter).

• Printer installed and printing a Windows test page.

• Local print bridge software installed.

• Firewall allowing local communication.

Step-by-Step Setup

Step 1: Install Printer Normally

Follow standard USB or Network installation:

• Install official driver.

• Confirm test page prints.

• Set printer as default.

Step 2: Install Print Bridge Software

The print bridge may be:

• Custom Node.js service

• POS-specific print service

• Middleware application

The service must:

• Run automatically on startup.

• Connect to the local printer.

• Accept requests from the POS.

Step 3: Configure POS Printer Settings

Inside your POS:

1. Go to Settings → Printing.

2. Select Receipt Printer.

3. Choose connection type (USB or Network).

4. Set paper size (80mm recommended).

5. Enable automatic printing.

6. Enable cash drawer (if applicable).

7. Save.

Step 4: Test Receipt Printing

Perform a test sale.

Confirm:

• Receipt prints instantly.

• Formatting is correct.

• Paper cuts automatically.

• Cash drawer opens (if connected).

Method 3: Network ESC/POS Printing (Advanced Setup)

For multi-terminal environments:

1. Install printer on network.

2. Assign static IP address.

3. Configure POS to send ESC/POS commands directly to printer IP.

4. Ensure port 9100 (standard raw printing port) is open.

This is ideal for:

• Restaurants

• Supermarkets

• Multi-counter stores

It removes the need for a local Windows driver in some configurations.

Important Configuration Notes

Paper Width

Always confirm your printer size:

• 80mm (most common in retail)

• 58mm (compact models)

Wrong paper width causes formatting issues.

Cash Drawer Setup

Cash drawers connect to the printer (not the PC).

To test:

• Print a test receipt.

• Confirm the drawer pops automatically.

If not:

• Enable “Open Cash Drawer” in POS settings.

• Confirm ESC/POS support.

Setting Static IP for Network Printers

For stability:

• Log into your router.

• Reserve the printer’s IP address.

• Prevent IP changes after reboot.

Changing IP addresses is one of the most common causes of network printing failure.

Troubleshooting Web-Based Printing

If receipt does not print:

• Printer test page does not print → driver issue.

• Windows prints but POS does not → print bridge issue.

• POS sends job but nothing prints → firewall blocking.

• Network printer stopped printing → IP changed.

• Receipt prints incorrectly → wrong paper size.

Professional Recommendation

For a production-grade retail system:

• Use ESC/POS compatible printer.

• Install official driver.

• Use a local print service or Node-based microservice.

• Assign static IP for network setups.

• Test both receipt and cash drawer.