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 modern browser (Chrome, Edge, Brave, Firefox or Safari).
- 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 |
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.
Inside the text box you can apply emphasis with markers:
| Type | Result on the receipt |
|---|
**text** | Bold |
***text*** | Bold + double width (highlighted title) |
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 |
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 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) |
