Skip to main content
Fire Agent is a local agent that lets any browser (FIRE POS, XMART, etc.) print to thermal POS printers over WebSocket. Once installed, it runs in the background and starts automatically with Windows. Install it once per Windows device that has a printer attached.

​
Prerequisites

The agent only listens on 127.0.0.1 (localhost), so it needs no open ports and no Windows Firewall rule.

​
Files you need

Depending on the task, you need one of these files:

Download Fire Agent (Windows)

Windows installer for local thermal printing.

​
Step-by-step installation

1

Run the installer as administrator

  1. Locate fireAgentSetup.exe.
  2. Right-click it and choose Run as administrator.
  3. If the User Account Control (UAC) prompt appears, click Yes.
If Windows SmartScreen shows “Windows protected your PC”, click More info → Run anyway.
2

Welcome screen

The wizard shows the Fire Agent 1.1.0 welcome message. Click Next.
Fire Agent setup wizard — welcome screen
3

Installation folder

Confirm the installation folder (C:\Program Files\FireAgent by default). Keeping the default path is recommended. Click Install.
Fire Agent setup wizard — installation folder
4

Automatic installation

The wizard performs, with no user input:
  1. Stops any previous instance of the agent.
  2. Copies fire-agent.exe to the installation folder.
  3. Stores the FIRE_AGENT_TOKEN as a system environment variable.
  4. Registers auto-start with Windows for all users.
  5. Registers the app in Add or Remove Programs.
  6. Creates the uninstaller inside the installation folder.
Fire Agent setup wizard — progress bar
Wait for the progress bar to finish and click Next.
5

Finish

The last screen confirms the installation and the configured token. To start the agent right away, leave Start Fire Agent now ticked and click Finish.
Fire Agent setup wizard — installation complete
6

First launch (SSL certificate)

On its first launch the agent generates a self-signed SSL certificate in %APPDATA%\FireAgent\ssl\ (pure JavaScript, no PowerShell) and trusts it in the current user’s store with certutil.exe. This lets HTTPS pages connect to wss://localhost:9101 without certificate warnings, with no admin prompt and in a GPO-friendly way.
Fire Agent is installed and starts automatically whenever a user signs in to Windows. It appears as an icon in the system tray (next to the clock).

​
Verify that the agent is running

Open this address in a browser or use PowerShell:
Expected response:
To list the detected printers:
You can also click the Fire Agent tray icon to open the information panel. For print tests, see Agent web tools.

​
Ports used

​
Uninstall

There are three methods. All remove the agent completely (files, configuration, certificate, auto-start and registry).
  1. Open Settings (Windows + I).
  2. Go to Apps → Installed apps.
  3. Find Fire Agent, open the menu (⋯) → Uninstall and confirm.
  4. If the UAC prompt appears, click Yes and follow the wizard.

​
Method 2 — Standalone uninstaller (fireAgentUninstall.exe)

Useful when the original installer is no longer available.
  1. Right-click → Run as administrator.
  2. Confirm in the dialog and follow the wizard (Next → Uninstall → Finish).

​
Method 3 — Silent uninstall (scripts or mass deployments)

From PowerShell or CMD as administrator:
The /S flag runs the uninstall with no windows and no confirmation.
Any of the three methods stops fire-agent.exe, removes the auto-start entry, the FIRE_AGENT_TOKEN variable and the SSL certificate, deletes the files in C:\Program Files\FireAgent\ and %APPDATA%\FireAgent\, and removes the Add or Remove Programs entry.

​
Troubleshooting

​
Appendix: what the installer changes on the system

Reference for system administrators.

​
Files

​
Windows registry

​
Supported environment variables (advanced)