Skip to main content
El Agente Fire es un agente local que permite que cualquier navegador (FIRE POS, XMART, etc.) imprima en impresoras térmicas de punto de venta a través de WebSocket. Una vez instalado, se ejecuta en segundo plano y arranca automáticamente con Windows. Instálalo una vez por cada equipo Windows que tenga una impresora conectada.

Requisitos previos

El agente escucha únicamente en 127.0.0.1 (localhost), por lo que no requiere abrir puertos ni crear reglas en el Firewall de Windows.

Archivos que necesitas

Según la tarea, necesitarás uno de estos archivos:

Descargar Agente Fire (Windows)

Instalador de Windows para impresión térmica local.

Instalación paso a paso

1

Ejecuta el instalador como administrador

  1. Localiza fireAgentSetup.exe.
  2. Haz clic derecho y selecciona Ejecutar como administrador.
  3. Si aparece el aviso de Control de cuentas de usuario (UAC), haz clic en .
Si Windows SmartScreen muestra el aviso “Windows protegió su PC”, haz clic en Más información → Ejecutar de todas formas.
2

Pantalla de bienvenida

El asistente muestra el mensaje de bienvenida de Fire Agent 1.1.0. Haz clic en Next (Siguiente).
Asistente de instalación del Agente Fire — pantalla de bienvenida
3

Carpeta de instalación

Confirma la carpeta de instalación (por defecto C:\Program Files\FireAgent). Se recomienda dejar la ruta predeterminada. Haz clic en Install (Instalar).
Asistente de instalación del Agente Fire — carpeta de instalación
4

Instalación automática

El asistente realiza, sin intervención del usuario:
  1. Detiene cualquier instancia previa del agente.
  2. Copia fire-agent.exe a la carpeta de instalación.
  3. Guarda el token FIRE_AGENT_TOKEN como variable de entorno del sistema.
  4. Registra el inicio automático con Windows para todos los usuarios.
  5. Registra la aplicación en Agregar o quitar programas.
  6. Crea el desinstalador dentro de la carpeta de instalación.
Asistente de instalación del Agente Fire — barra de progreso
Espera a que la barra de progreso termine y haz clic en Next (Siguiente).
5

Finalizar

En la última pantalla aparece la confirmación de la instalación y del token configurado. Para iniciar el agente de inmediato, deja marcada la casilla Start Fire Agent now y haz clic en Finish (Finalizar).
Asistente de instalación del Agente Fire — instalación completada
6

Primer arranque (certificado SSL)

La primera vez que el agente se inicia, genera un certificado SSL autofirmado en %APPDATA%\FireAgent\ssl\ (en JavaScript puro, sin PowerShell) y lo instala como confiable en el almacén del usuario actual con certutil.exe. Esto permite que las páginas HTTPS se conecten a wss://localhost:9101 sin advertencias, sin pedir permisos de administrador y de forma compatible con equipos con GPO.
El Agente Fire queda instalado y arranca automáticamente cada vez que un usuario inicia sesión en Windows. Aparece como un icono en la bandeja del sistema (junto al reloj).

Verificar que el agente funciona

Abre esta dirección en el navegador o usa PowerShell:
Respuesta esperada:
Para listar las impresoras detectadas:
También puedes hacer clic en el icono de Fire Agent en la bandeja del sistema para abrir el panel informativo. Para pruebas de impresión, consulta Web del agente.

Puertos utilizados

Desinstalación

Existen tres métodos. Todos eliminan el agente por completo (archivos, configuración, certificado, inicio automático y registro).

Método 1 — Agregar o quitar programas (recomendado)

  1. Abre Configuración (Windows + I).
  2. Ve a Aplicaciones → Aplicaciones instaladas.
  3. Busca Fire Agent, abre el menú (⋯) → Desinstalar y confirma.
  4. Si aparece el aviso de UAC, haz clic en y sigue el asistente.

Método 2 — Desinstalador independiente (fireAgentUninstall.exe)

Útil cuando el instalador original ya no está disponible.
  1. Haz clic derecho → Ejecutar como administrador.
  2. Confirma en el cuadro de diálogo y sigue el asistente (Siguiente → Desinstalar → Finalizar).

Método 3 — Desinstalación silenciosa (scripts o despliegues masivos)

Desde PowerShell o CMD como administrador:
El parámetro /S ejecuta la desinstalación sin mostrar ventanas ni pedir confirmación.
Cualquiera de los tres métodos detiene fire-agent.exe, elimina el inicio automático, la variable FIRE_AGENT_TOKEN y el certificado SSL, borra los archivos de C:\Program Files\FireAgent\ y %APPDATA%\FireAgent\, y quita la entrada de Agregar o quitar programas.

Solución de problemas

Anexo: qué cambia el instalador en el sistema

Referencia para administradores de sistemas.

Archivos

Registro de Windows

Variables de entorno admitidas (avanzado)