← Back to Hotel360
Hotel360

Printing Setup Guide

Hotel360 · v1.0.29 · Updated November 2026

This guide walks you through every way Hotel360 can print receipts, bills and kitchen orders: USB and Ethernet / IP thermal printers via the Print Agent, and direct printing from the mobile app (bypassing the agent). Pick the section that matches your hardware.

Contents

  1. Overview — how Hotel360 prints
  2. Installing the Print Agent
  3. USB printing (with printer sharing)
  4. IP / Ethernet printer configuration
  5. Mobile app direct printing (bypass agent)
  6. Troubleshooting

1. Overview — how Hotel360 prints

Hotel360 supports three printing paths. You configure each printer once in Office → Print Management. Prints from the web app always go through the Print Agent; only the mobile app can print directly.

Path A · IP / Ethernet via Print Agent

Agent required. The Print Agent on a computer in the same network sends receipts to the printer’s IP address (port 9100). No drivers or printer sharing needed.

Path B · USB via Print Agent

Agent required. The Hotel360 Print Agent runs on the PC where the printer is plugged in, keeps a live connection open to Hotel360, and prints to the locally shared printer whenever a receipt is sent. Use this for USB-only receipt printers.

Path C · Mobile direct

No agent, no middleman. The Hotel360 mobile app talks directly to the Ethernet printer over the hotel Wi-Fi. Ideal for waiters taking orders on the floor.

Rule of thumb: If your thermal printer has an Ethernet port, use Path A (and Path C for mobile). Only fall back to Path B if the printer is USB-only. Either way, the agent must be running whenever the business is open.

2. Installing the Print Agent

Download the installer for your operating system from the Hotel360 landing page:

  1. Place the file in a permanent folder, e.g. C:\Hotel360\ on Windows or ~/hotel360/ on Linux/macOS.
  2. Double-click to launch (Windows) or run ./hotel360-print from a terminal.
  3. On first run the agent asks “Paste the agent token from Print Management”. In Hotel360 open Office → Print Management → Agent Token, press Generate Token if there is none, copy it and paste it into the agent.
  4. The agent connects, finds the printers on that computer, reports them to Hotel360 and installs itself to start with the computer. The printers then appear on the Printers tab of Print Management.
  5. Future updates are downloaded and applied automatically — just leave it running.
Tip — keep the agent running. Setup installs the agent to start automatically at boot. If the computer is off or the agent stopped, prints wait in the queue and nothing comes out. Also open Print Management → Computer ID in each till’s browser and pick that computer’s name.

3. USB printing — printer sharing is mandatory

USB thermal printers don’t expose a raw byte device the way Ethernet printers do. The Print Agent works around this by writing to the printer via its shared name. This means you must share the printer — even if it’s only going to be used by the same PC. This is the single most common cause of “agent found, printer silent” tickets.

3.1 Windows — share the USB printer

  1. Install the printer driver that came with your thermal printer (or the built-in Generic / Text Only driver for basic models). Confirm you can print a Windows test page from Devices and Printers.
  2. Right-click the printer → Printer properties → Sharing tab.
  3. Tick Share this printer. Set a simple share name with no spaces, e.g. POS01, KITCHEN, BAR. Hotel360 uses this exact name.
  4. Open Control Panel → Network and Sharing Center → Advanced sharing settings and enable File and printer sharing for the Private profile.
  5. Back in Devices and Printers, double-check your printer now shows a small "shared" icon and that the share name matches what you entered.
  6. Restart the Print Agent. In Office → Print Management → Printers the printer will appear with its shared name. Print a bill to test it.
No share = no print. If the printer appears in the agent but jobs fail with “Failed to copy to \\HOST\NAME. Is the printer shared?”, the share step was skipped or the share name has spaces. Re-share with a simple name and retry.

3.2 Linux / macOS — install the printer in the system

  1. Plug in the printer and add it from System Settings → Printers. On Linux you can also open http://localhost:631 in a browser to manage printers. Choose the "raw" option if you see it.
  2. Open a terminal and confirm the printer is listed:
    lpstat -a
  3. Send a quick test print from the terminal to confirm the system is talking to the printer:
    echo "Hello" | lp -d YOUR_PRINTER -o raw
  4. Restart the Print Agent — it will pick the printer up automatically.

4. IP / Ethernet printer configuration

Ethernet thermal printers are plug-and-play with Hotel360. Just give the printer an IP address on your network and the Print Agent on a computer in the same network will send receipts to it — no drivers to install and no printer sharing.

4.1 Give the printer a static IP

  1. Most thermal printers can print their current network configuration by holding the Feed button while powering on. Note the MAC address and current IP.
  2. In your router’s DHCP settings, reserve a static lease for that MAC (recommended) — or configure a static IP via the printer’s built-in web panel.
  3. Make sure the printer is on the same network as the Hotel360 computer or device that will print to it.

4.2 Check the printer is reachable

From any PC on the same network, open a command window and run:

# Replace with your printer IP
ping 192.168.1.50

If you get replies back, the printer is on the network and Hotel360 can talk to it. If the ping times out, the printer is off, cabled to the wrong switch, or on a different Wi-Fi — fix that before continuing.

4.3 Add the printer in Hotel360

  1. Make sure the Print Agent is running on a computer in the same network (section 2). The printer does not need to be plugged into it.
  2. Open Office → Print Management → Printers. The agent’s printers are listed there; you do not add printers by hand. For the network printer, type its IP Address and Port (leave it at 9100 unless the printer manual says otherwise) and make sure ESC/POS says Yes.
  3. Open Department Printers, press Add Printer to the department, choose the Computer, the Printer and the Type (Bill, Order, Receipt or Cashier), set the copies and press Add. For lodge receipts pick the printer on the Accommodation tab.
  4. Make a sale or booking and check that it prints.
Why Ethernet is preferred: no drivers or sharing to set up, and the agent can be on any computer in the network. You can also print to the same printer from the mobile app (next section).

5. Mobile app direct printing (bypassing the agent)

The Hotel360 mobile app can print directly to any Ethernet thermal printer over the hotel’s Wi-Fi. No agent, no middleman — the phone talks to the printer itself. This is the path used by waiters and bar staff working on the floor.

5.1 Install the APK

  1. From a phone browser, go to the Hotel360 landing page and tap Download APK.
  2. Allow installation from unknown sources if prompted.
  3. Open the app, log in with your Hotel360 credentials (the app enforces the same permissions as the web app).

5.2 Connect the phone to the printer network

  1. Connect your phone to the same Wi-Fi network as your IP printers. Guest/isolated SSIDs block device-to-device traffic and will prevent printing.
  2. Ensure the printer already works from the server (see Section 4). If the web app can print to it, the phone can too.

5.3 Select the printer in Settings

  1. Tap the Settings tab in the app.
  2. Under Printer, tap Select printer. The app lists every Ethernet printer registered on the server.
  3. Pick one. The app saves your choice locally and shows its IP and port (e.g. 192.168.1.50:9100).
  4. Tap Test print to confirm bytes reach the printer.

5.4 Print from POS, bills and lodge

How “bypass” works in practice: Hotel360 only prepares the receipt content (headers, items, totals). The phone then delivers it straight to the printer over Wi-Fi — the Print Agent and the real-time service on the server are not involved at all. If your phone can reach the printer on the network, it can print.
Mobile direct printing only works with IP printers. USB-only printers must go through the Print Agent path because they have no network endpoint the phone could reach.

6. Troubleshooting

Nothing prints, no errors

Agent says “Failed to copy to \\HOST\NAME”

Agent connects then disconnects

Mobile: “No printer configured”

Web prints fine but phone doesn’t

Receipt prints but text is garbled