Saltar al contenido

Buscar en el centro de ayuda

Escribe para encontrar una guía.

Instalar QZ Tray

Instala QZ Tray en la computadora que imprime y autoriza a La Comanda con el certificado para que no vuelva a pedir permiso.

Actualizado el 9 de octubre de 2026

El navegador no puede hablar directo con una impresora térmica. QZ Tray es la aplicación gratuita que recibe el ticket dentro de la misma computadora y lo manda a la impresora que elegiste; nada sale a internet. Se instala una sola vez en cada computadora que va a imprimir y toma unos diez minutos.

Antes de empezar

  • Necesitas una computadora con macOS, Windows o Linux. Las tabletas y los celulares no pueden imprimir tickets térmicos.
  • La impresora debe estar instalada en el sistema operativo. La regla corta: si tu computadora ya puede imprimir una página de prueba en esa impresora, La Comanda también puede. Si tienes dudas de tu modelo o de la conexión, revisa Impresoras compatibles.

Paso 1: instala QZ Tray

  1. Descarga QZ Tray desde qz.io/download e instálalo como cualquier otro programa.
  2. Confirma que quedó corriendo. Al terminar, QZ Tray se queda en segundo plano: busca su ícono en la barra de menús en Mac o en la bandeja del sistema en Windows, junto al reloj (puede estar bajo la flecha ^). Si no está abierto, no se puede imprimir.

QZ Tray escucha de forma local en los puertos 8181, 8282, 8383 y 8484, y en 8182, 8283, 8384 y 8485. Si tu antivirus o firewall pregunta, autorízalo: es tráfico dentro de la misma computadora y no sale de tu red.

Paso 2: autoriza a La Comanda

De fábrica, QZ Tray muestra un aviso de seguridad cada vez que algo quiere imprimir. Este paso instala un certificado que le dice que confíe en La Comanda, para que el aviso no vuelva a salir.

  1. Abre Configuración → Punto de venta (/admin/settings/pos) y baja a la tarjeta Impresora.
  2. Presiona Asistente de configuración. El asistente detecta tu sistema operativo.
  3. Marca Ya instalé QZ Tray para pasar al certificado.
  4. Presiona Descargar instalador y ejecútalo. Depende del sistema:
    • macOS: descarga "La Comanda Printer Setup.pkg". Haz doble clic, presiona Continuar y luego Instalar, y escribe tu contraseña de Mac. También puedes usar la opción de Terminal: Copiar comando, pégalo en la app Terminal y espera el mensaje "Printer setup complete".
    • Windows: descarga setup-printer.bat y ábrelo con doble clic desde Descargas. Si aparece el aviso de SmartScreen, presiona Más información y Ejecutar de todas formas; en el cuadro azul de Control de cuentas de usuario, Sí. Termina cuando veas "Printer setup complete".
    • Linux: Copiar comando, pégalo en una terminal con Ctrl+Shift+V, presiona Enter y escribe tu contraseña. El script usa pkexec si hay entorno gráfico y sudo si no, y espera encontrar QZ Tray en /opt/qz-tray.
  5. Marca Ya ejecuté el instalador y presiona Probar conexión. Debe decir ¡Conexión exitosa! y después ¡Todo listo!.

¿Por qué pide contraseña? El certificado se copia dentro de la carpeta de QZ Tray, que está protegida por el sistema. La contraseña autoriza esa única copia; nada se envía a internet.

Los mismos instaladores están en la guía pública de impresoras, por si prefieres descargarlos sin entrar al panel. Todos los instaladores comprueban primero que QZ Tray esté instalado y, al terminar, lo reinician con el certificado ya cargado.

Paso 3: vuelve a abrir QZ Tray si sigue preguntando

QZ Tray solo lee el certificado cuando arranca. El instalador lo reinicia por ti, pero si al imprimir sigue saliendo el aviso, ciérralo desde su ícono (clic derecho › Exit en Windows, Quit en la barra de menús de Mac), ábrelo de nuevo y recarga la página de La Comanda. Para confirmar que el certificado quedó en su lugar: clic derecho en QZ Tray › Advanced › Diagnostic › Browse App folder…; ahí debe existir el archivo override.crt.

Si QZ Tray muestra su aviso

Con el certificado instalado, el aviso dice Verified y basta con elegir Allow una vez; no vuelve a aparecer. Si lo ves sin "Verified", el certificado no está en esa computadora: repite el paso 2.

Nunca elijas Block con Remember this decision marcado. Sin el certificado, marcar esa casilla desactiva Allow, así que la única respuesta que QZ Tray puede recordar es Block; la guarda en la carpeta del usuario, y ni reinstalar QZ Tray ni reiniciar la computadora la borran. Si ya pasó, el bloqueo se quita en QZ Tray: clic derecho en su ícono › Advanced › Site Manager… › pestaña Blocked, selecciona "La Comanda (La Comanda POS)" y presiona −. El desbloqueo completo, paso a paso, está en Solución de problemas de impresión.

Siguiente paso

Con QZ Tray autorizado, elige tus impresoras y el tamaño de papel en Configurar tu impresora.

¿Te sirvió esta página?