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.
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:
- Windows →
hotel360-print.exe
- Linux →
hotel360-print
- macOS →
hotel360-print-macos
- Place the file in a permanent folder, e.g.
C:\Hotel360\ on Windows or ~/hotel360/ on Linux/macOS.
- Double-click to launch (Windows) or run
./hotel360-print from a terminal.
- 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.
- 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.
- 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
- 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.
- Right-click the printer → Printer properties → Sharing tab.
- Tick Share this printer. Set a simple share name with no spaces, e.g.
POS01, KITCHEN, BAR. Hotel360 uses this exact name.
- Open Control Panel → Network and Sharing Center → Advanced sharing settings and enable File and printer sharing for the Private profile.
- Back in Devices and Printers, double-check your printer now shows a small "shared" icon and that the share name matches what you entered.
- 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
- 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.
- Open a terminal and confirm the printer is listed:
lpstat -a
- 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
- 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
- Most thermal printers can print their current network configuration by holding the Feed button while powering on. Note the MAC address and current IP.
- 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.
- 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
- 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.
- 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.
- 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.
- 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
- From a phone browser, go to the Hotel360 landing page and tap Download APK.
- Allow installation from unknown sources if prompted.
- 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
- 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.
- 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
- Tap the Settings tab in the app.
- Under Printer, tap Select printer. The app lists every Ethernet printer registered on the server.
- Pick one. The app saves your choice locally and shows its IP and port (e.g.
192.168.1.50:9100).
- Tap Test print to confirm bytes reach the printer.
5.4 Print from POS, bills and lodge
- POS checkout: use Save & Print — the app builds the receipt and sends it directly to your selected printer.
- Bill clearing: after clearing a bill (Cash or Co-op STK) tap Print receipt.
- Lodge booking: after creating a booking, tap Print receipt to produce a lodge slip.
- Reprint: open any past bill and tap Reprint.
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
- Check the printer has paper and the lid is closed — receipt printers silently drop jobs when out of paper.
- Confirm the printer is on the same network as the device sending the job.
- Run the ping check in Section 4.2.
Agent says “Failed to copy to \\HOST\NAME”
- The Windows printer is not shared, or the share name contains spaces or special characters.
- Re-share with a simple name (
POS01, KITCHEN) and retry.
- Make sure File and printer sharing is enabled for the Private network profile.
Agent connects then disconnects
- Your firewall or antivirus may be blocking the live connection to Hotel360. Allow the Hotel360 Print Agent through Windows Defender / your firewall and try again.
- The agent token may have been rotated — grab a new one from
Office → Print Management → Agent Token and paste it into the agent.
Mobile: “No printer configured”
- Open Settings → Printer in the app and select one.
- If the list is empty, make sure the printer is added as an IP printer on the web (Section 4.3).
Web prints fine but phone doesn’t
- Your Wi-Fi is likely set to guest mode (client isolation). On guest Wi-Fi, phones can’t talk to other devices on the network, including printers.
- Connect the phone to the same Wi-Fi the printer is on, or ask your IT to turn off guest isolation.
Receipt prints but text is garbled
- The printer is probably using the wrong driver. On Windows, remove the printer, reinstall it using the Generic / Text Only driver, then share it again.