--- id: "printer-setup" lang: "en" title: "Receipt printer setup: Epson, browser or cloud" summary: "Choose how each shop prints: through the browser, straight to an Epson printer, through a cloud bridge, or not at all. Then send a test print." area: "Settings & account" kind: "task" url: "https://zeropos.shop/help/printer-setup" alternate: "https://zeropos.shop/help/printer-setup?lang=es" markdown: "https://zeropos.shop/help/md/en/printer-setup.md" screens: ["/backoffice/settings/printer","/backoffice/settings/printer/queue"] where_to_find: ["MANAGE › Settings › Printer"] related: ["receipts-and-printing","locations","quick-prints","make-a-sale"] updated: "2026-10-08" --- # Receipt printer setup: Epson, browser or cloud Choose how each shop prints: through the browser, straight to an Epson printer, through a cloud bridge, or not at all. Then send a test print. Each shop has its own printer mode. What you type on the printer page depends on that mode, so pick it first. Where to find it: MANAGE › Settings › Printer. ## Before you start - The printer is switched on, loaded with 80 mm paper and on the same network as the shop. ## Steps ### Choose each shop's mode 1. Open [MANAGE › Settings › Printer](https://app.zeropos.shop/backoffice/settings/printer). 2. Under **Global defaults**, keep **Default paper format** on **80mm thermal** unless every shop prints on A4, and tap **Save defaults**. 3. Under **Locations**, find the shop and pick its **Mode**. 4. Fill in what that mode asks for (below) and tap **Save** on the shop's row. ### Epson ePOS (network) 5. Connect the Epson printer to the shop's network by cable or Wi-Fi. 6. Print its self-test (hold the feed button for 5 seconds while switching it on) to find its IP address. 7. Turn on ePOS-Print in the printer's web page: **Show Epson ePOS setup instructions** lists every step. 8. Paste the address into **ePOS-Print URL**. Switch on **Kick cash drawer** if a drawer is plugged into the printer. 9. Tap **Save**, then **Test print**. ### Cloud bridge (Termux / Pi) 10. Type the **Printer IP**, the **Port** (usually 9100) and a **Bridge name**. 11. Tap **Generate bridge token** and copy it at once: it is shown only once. 12. Paste the token into the bridge program on the Android phone (Termux) or Raspberry Pi next to the printer, and start it. 13. Tap **Save**. The shop's row shows “Live” once the bridge checks in. 14. Tap **Test print**. ### Browser (macOS / Windows) 15. Install the receipt printer on the shop's computer like any other printer. 16. Ring up a sale and tap **Print receipt**: the computer's print dialog opens. 17. Choose the receipt printer and an 80 mm roll paper size, with **Margins → None** and **Scale → 100%**. ### Watch the print queue (cloud bridge) 18. On the printer page, tap **Print queue**. 19. Filter by shop or status. The list refreshes itself every 5 seconds. 20. **Retry** a **Failed** job, or cancel one still **Queued**. ## What happens next - Receipts from the till print the way that shop's mode says. With **No printer**, nothing prints there; receipts can still be emailed. - With **Open cash drawer** switched on under **Global defaults**, the drawer opens after each cloud-bridge receipt. Epson shops use their own **Kick cash drawer** switch. - Jobs sent through a cloud bridge wait in the **Print queue** until the bridge prints them. - The test page prints in the shop's **Customer language**, like every receipt. The **Print queue** names each job in the language of whoever is reading it: a receipt or a refund by its number, total and customer. ## Which mode to choose **Browser (macOS / Windows)**: the computer's own print dialog. Simplest to start with, one extra tap per receipt. **Epson ePOS (network)**: Zero POS sends straight to an Epson TM printer on the network. No dialog, and it can open the cash drawer. **Cloud bridge (Termux / Pi)**: a small program on a device in the shop fetches the jobs and prints them, so any phone, tablet or computer can print to it. ## Common questions ### We lost the bridge token. What now? Tap **Rotate bridge token** to get a new one and paste it into the bridge. The old token stops working. ### The receipt printed in the other shop. Why? Next to each print button, the **Print at …** chip says which shop's printer it uses. Tap it and choose your shop. ### In Browser mode the receipt stretches over a whole A4 page. The computer's paper size is still A4. On a Mac, **Show browser-printer setup (Epson TM-m30III on macOS)** explains the right driver and paper size. ## If you see this - “**Never seen**, or a red dot next to the bridge” — What to do: The bridge isn't running or can't reach the internet. Restart it on its device and check it has this shop's latest token. - “**No token yet — generate one before starting the bridge.**” — What to do: Tap **Generate bridge token**, copy it, paste it into the bridge, then start it. - “**The active 'Print at' shop isn't set to Cloud bridge mode. Switch shops or open Settings → Printer to enable it.**” — What to do: Choose another shop in the **Print at …** chip, or set this shop's **Mode** to **Cloud bridge (Termux / Pi)**. - “The same receipt printed twice” — What to do: A job marked **Failed** may already have printed before the bridge could confirm it. Check the paper before tapping **Retry**. ## Good to know - Send a **Test print** (Epson or cloud bridge) each morning before opening: it tells you the printer, the paper and the network are all ready. ## Related guides - [Design the receipt](https://zeropos.shop/help/md/en/receipts-and-printing.md) - [Add a shop or storage location](https://zeropos.shop/help/md/en/locations.md) - [Quick prints](https://zeropos.shop/help/md/en/quick-prints.md) - [Make a sale](https://zeropos.shop/help/md/en/make-a-sale.md)