Connect your thermal printer

Also known as: printer setup, configure printer, thermal printer install, Epson TM-T20, 80mm printer, ESC/POS bridge install, kiosk printing.

brasio supports two printing paths:

• PDF path (simple setup): The browser generates a PDF and sends it to the OS default printer. No brasio admin config needed — set the printer as the default at the OS level.
• ESC/POS bridge (multi-printer routing): A small background service (brasio-print-bridge) runs on your till computer and receives print jobs directly from brasio over the internet. Each job is routed to the correct printer based on category (e.g. kitchen ticket to the kitchen printer, receipt to the till printer). Installed from a downloadable Windows package — no technical knowledge required. It also powers the manager Abrir cajón (open till) button (which pops the cash drawer without printing anything) and lets a waiter print a table's pre-bill (precuenta) straight from the handheld.

The PDF path is simpler and works with any OS. The ESC/POS bridge path scales to multiple printers and requires no Chrome kiosk flag.

---

Part A — PDF path (browser printing)

A1. Connect the printer to the network

1. Plug the printer into the mains and into your router with an Ethernet cable.
2. Switch it on and let it warm up. Most Epson TM-T20 units print a self-test page automatically showing the IP they received from DHCP.
3. If no page comes out, hold the Feed button for a few seconds while the printer is on.

Note the IP shown on the page, for example 192.168.1.50.

A2. Reserve the IP in the router

Log in to the venue's router and create a DHCP reservation that ties the printer's MAC address (also on the self-test page) to a fixed IP. Without this, the printer may get a new IP after a power cut and stop printing.

A3. Install the printer on the till's operating system

Install the printer as the default printer:

• Windows: Settings → Bluetooth & devices → Printers & scanners → Add a printer. Search by IP if not auto-discovered. Set it as default.
• macOS: System Settings → Printers & Scanners → Add (+). Enter the printer IP. Set as default.
• iPad / Android: Install the manufacturer's app (Epson iPrint, etc.) and follow the pairing steps, or use AirPrint if supported.

A4. Enable silent printing (Chrome kiosk mode)

For a proper till experience where print dialogs never appear, launch Chrome with the --kiosk-printing flag:

chrome --kiosk-printing https://<your-slug>.brasio.io

Add this flag to a desktop shortcut or startup script so it is always active. Without --kiosk-printing, Chrome shows the print dialog each time — the ticket still prints, it just requires a tap to confirm.

A5. Test

Go to a table in the till, add a product to an order and tap Cocina (kitchen ticket button). If the printer is correctly set as the OS default, the ticket should come out.

If nothing prints, check:

• The printer is set as the OS default printer.
• The printer is powered on and has paper.
• Chrome is running with --kiosk-printing if you want silent mode.
• The printer is reachable on the network (try pinging its IP from the till device).

For further troubleshooting, see Printer not printing.

---

Part B — ESC/POS bridge (multi-printer routing)

The ESC/POS bridge lets brasio route kitchen tickets to a kitchen printer and receipts or pre-bills to a till printer — or any other combination you configure.

B1. Requirements

• A Windows 10/11 (64-bit) till computer that stays on during service.
• Your thermal printer(s) on the same network, each with a fixed IP (see A1–A2).
• Administrator rights on the till computer (only needed once, during installation).

macOS and Linux versions are not packaged yet — contact support if you need one.

B2. Download the bridge

On the till computer, download the installer package:

https://brasio.io/downloads/brasio-print-bridge-win-x64-1.0.0.zip

Unzip it to a permanent folder, e.g. C:\brasio-bridge (not the Downloads folder, and not inside the zip).

B3. Generate a bridge token in the brasio admin

1. Log in to your brasio admin at <your-slug>.brasio.io/account/printers.
2. In the Token del bridge section, click Generar token.
3. The token is shown once — copy it. (Generating a new token invalidates the previous one.)

B4. Configure

Open config.json in the unzipped folder with Notepad and replace PASTE_BRIDGE_TOKEN_HERE with your token, then save:

{
  "apiUrl": "https://<your-slug>.brasio.io/api",
  "token": "bridge_<tenantId>_<random>"
}

apiUrl uses your own brasio subdomain — the same address you use for the till, plus /api.

B5. Install

Right-click install.bat → Run as administrator. This registers the bridge as a hidden background task that starts automatically every time Windows boots, and starts it immediately. There is no window or tray icon — all activity is written to bridge.log in the same folder.

After about 30 seconds, the bridge status indicator in account/printers turns green.

Re-running install.bat is always safe — it replaces the previous installation (do this after changing config.json). To remove the bridge, run uninstall.bat as administrator.

B6. Add printers in the brasio admin

1. Go to <your-slug>.brasio.io/account/printers.
2. Click + Añadir impresora.
3. Fill in:
   • Nombre — e.g. Cocina or Caja
   • Dirección IP — the printer's fixed LAN IP, e.g. 192.168.1.50
   • Puerto — 9100 (standard for Epson and most thermal printers)
   • Modelo — optional, e.g. Epson TM-T20
   • Ancho del papel (mm) — 80 for standard thermal paper
   • Check Impresora predeterminada del negocio if this printer should receive all jobs that aren't explicitly routed to another printer
4. Click Añadir impresora.

Mark one printer as Impresora predeterminada. Receipts and pre-bills always go to the default printer. If no default is set, POST /send-to-kitchen will return a printer.no_default error.

B7. Assign category destinations (optional)

To route kitchen tickets to a specific printer:

1. In the terminal admin, open Catálogo and edit a category.
2. Use the Destino de impresión dropdown to pick the target printer.
3. Subcategories inherit this setting unless overridden individually.
4. Categories with no destination set walk up the parent chain, then fall back to the default printer.

Leave drink categories set to (Por defecto del sistema) — they will fall back to the default printer automatically.

B8. Test each printer

In account/printers, click Probar next to each printer. If the bridge daemon is connected and the printer is reachable, a test ticket prints. If the button shows an error, see the troubleshooting section below.

---

Troubleshooting

Bridge shows offline in the admin

The bridge cannot reach the brasio API, or is not running. On the till computer check:

• Open bridge.log in the bridge folder. BRIDGE TOKEN REJECTED (401) means the token in config.json is wrong or was regenerated in the admin — paste the current token and run install.bat again.
• Internet connection on the till computer.
• The background task exists: run schtasks /query /tn BrasioPrintBridge in a command prompt. If it's missing, run install.bat as administrator again.

Test print fails

The bridge can reach brasio but cannot reach the printer. Check:

• The printer IP is correct in the admin.
• Run telnet <printer-ip> 9100 from the bridge computer — if it hangs or refuses, the printer is not reachable on that port.
• Confirm the printer and the bridge computer are on the same LAN segment.
• Confirm the printer has a fixed IP (DHCP reservation) and hasn't changed addresses.

Jobs queued but never printed

• Check bridge.log in the bridge folder for connection or printer errors — every job and every error is logged with a timestamp.
• The printer may be off, out of paper, or have its cover open. Resolve the hardware state — the bridge retries automatically (up to 3 times with backoff), and failed jobs are reported back to brasio.

printer.no_default error when sending to kitchen

No printer is marked as default. Go to account/printers, edit a printer, and check Impresora predeterminada del negocio.

Impresora no encontrada (¿eliminada?); se usará la predeterminada.

A category's destination printer was deleted. The system falls back to the default printer. Edit the category in the terminal admin catalog and re-select a valid printer from the Destino de impresión dropdown.