Agent web tools

Fire Agent ships with two built-in web pages served by the agent itself (no internet needed). Use them to check status, diagnose and run print tests without the point-of-sale app. Both are only reachable from the same machine where the agent runs, because it listens only on 127.0.0.1 (localhost).

Page	Address	Purpose
Test page	`http://localhost:9100/`	Connect, list printers and print test receipts
Information panel	`http://localhost:9100/panel`	View status, version, updates, printers and URLs (read-only)

If you changed the port with FIRE_AGENT_PORT, use that number instead of 9100.

Prerequisites

Fire Agent must be installed and running (icon visible in the system tray). If it is not, see Windows installation.
A supported browser: Chrome or Edge 105+, Brave, Opera or Firefox 110+. See terminal requirements.
The agent token (FIRE_AGENT_TOKEN). On fresh installs the default is fire-agent-dev-token; in production it is the value set during installation.

Click the Fire Agent tray icon to open the information panel directly in the browser.

Test page

The test page lets you connect to the agent and print sample receipts. It is the main tool to confirm that a printer works. The interface has a left sidebar with four sections (Connection, Printers, Print, Log) and a Connect / Disconnect button in the top right.

Open the page

Open http://localhost:9100/ in the browser. The Fire Agent interface appears.

Connection

This is the section shown when the page opens.

In the FIRE_AGENT_TOKEN field, enter the agent token. Use the eye icon to show or hide it.
Click Connect (top right).
The status indicator changes:
- Connecting… (yellow): establishing the connection.
- Connected (green): connection successful.
- Error (red): could not connect (check that the agent is running).
On a successful connection, the agent lists the printers automatically and the button changes to Disconnect.

Printers

Click Printers in the sidebar.
You see the printers detected in Windows. The default one is marked (default).
Select a printer in the Select printer dropdown. The selection is saved for next time.
If you connected a new printer, click Refresh to query them again.

If no printer appears, install its driver from Windows settings first, then click Refresh.

Print

This section sends test print jobs to the selected printer.

Make sure you selected a printer in the previous section.
Edit the receipt content in the ESC/POS content box (it comes with a preloaded example).
Use one of the four buttons:

Button	Action
Print test	Prints the text box content (without cutting the paper)
Print + cut	Prints the content and cuts the paper at the end
Open drawer	Sends the pulse to open the cash drawer connected to the printer
Cut only	Feeds paper and cuts, without printing text

The result of each action appears in the Log section.

Log

Shows, with a timestamp, every message exchanged with the agent:

Yellow: messages sent (→) to the agent.
Green: successful responses (← print_ok, printers, pong).
Red: errors (← ERROR: …).

Use Clear to empty the log. It is the first place to check when something fails.

Receipt formatting

Inside the text box you can apply emphasis with markers:

Type	Result on the receipt
`text`	Bold
`*text*`	Bold + double width (highlighted title)

The content is centered automatically and feed lines are added at the end.

Automatic saving

The page remembers its setup in the browser (localStorage):

Data	Saved when	Restored on open
Token	Each time you click Connect	The token field is filled
Printer	When selected or printed	Selected in the dropdown
Receipt content	Each time you print	The text box is filled

If the token is already saved, the agent connects on its own when the page opens and lists the printers.

Information panel

The panel is a read-only view (it does not print). It summarizes the agent status and refreshes itself every 30 seconds.

Open it at http://localhost:9100/panel (or click the Fire Agent tray icon). The sidebar has four sections:

Section	Information shown
Status	Agent version, uptime, platform and an activity indicator
Updates	Whether auto-update is active, remote version, status and last check
Printers	Detected printers with their status
Connection	Connection URLs: `ws://localhost:9100`, `wss://localhost:9101` and `/health`

The ↻ Refresh button forces an immediate refresh of all data. The Printers section shows the detected printers and their status as cards:

Fire Agent information panel — Printers section

The Connection section shows the URLs available to connect to the agent:

Fire Agent information panel — Connection section

The status indicator turns Offline (red) if the agent stops responding.

Light / dark theme

Both pages have a theme button (sun/moon icon) in the top-right corner. Clicking it toggles between dark and light mode, and the preference is saved in the browser.

Troubleshooting

Symptom	Likely cause	Fix
The page does not load (`localhost refused to connect`)	The agent is not running	Start Fire Agent (tray) or restart the PC; verify with `http://localhost:9100/health`
Error status when clicking Connect	The agent is not responding or the port changed	Confirm the agent is active and you are using the correct port (`FIRE_AGENT_PORT`)
The log shows `ERROR: ... 1001` or `Unauthorized`	Wrong token	Enter the correct token in the Connection section and reconnect
No printer appears	The driver is not installed in Windows	Install the driver from Windows settings and click Refresh
The receipt prints but does not cut	The printer does not support the cut command	Use Print test (no cut) or check your printer manual
The drawer does not open	Different drawer wiring or voltage	Check that the drawer is connected to the printer’s RJ port and powered on
The POS HTTPS page cannot connect to `wss://localhost:9101`	The browser does not trust the self-signed certificate	Open `https://localhost:9101/health` once and accept the warning, or import the certificate (see Windows installation)

Kiosk

POS

KDS

BOH

Fire Agent

Backoffice

PayBridge

Prerequisites