Instalación de OpenTPV¶

Producto: OpenTPV | Módulo: Guía de Inicio | Última actualización: 2026-03-18

Introducción¶

Esta guía lo acompañará paso a paso en el proceso de instalación de OpenTPV en su computador. Al finalizar, tendrá el sistema completamente instalado y listo para la configuración inicial.

Requisitos Previos¶

Antes de comenzar la instalación, asegúrese de contar con lo siguiente:

Sistema operativo: Windows 10 (versión 1903 o superior) o Windows 11
Permisos: Cuenta de administrador en el equipo
Espacio en disco: Al menos 2 GB libres
Conexión a internet: Necesaria para descargar componentes adicionales
Instalador de OpenTPV: Descargado desde el portal de clientes o proporcionado por su ejecutivo comercial

ℹ️ Nota: Si no cuenta con el instalador, solicítelo a soporte@openx.cl indicando su número de licencia.

Paso 1: Verificar Requisitos del Sistema¶

Antes de iniciar la instalación, verifique que su equipo cumple con los requisitos mínimos.

Verificar la versión de Windows¶

Presione Win + R para abrir el cuadro de diálogo Ejecutar
Escriba winver y presione Enter
Verifique que la versión sea Windows 10 (1903+) o Windows 11

Ventana Acerca de Windows

Verificar .NET Framework¶

OpenTPV requiere .NET Framework 4.8 o superior.

Abra el Panel de Control → Programas → Programas y características
Busque "Microsoft .NET Framework" en la lista
Verifique que la versión sea 4.8 o superior

Si no está instalado, el instalador de OpenTPV lo descargará automáticamente.

Verificar espacio en disco¶

Abra el Explorador de archivos
Haga clic derecho en la unidad C: → Propiedades
Confirme que dispone de al menos 2 GB libres

Paso 2: Instalar MariaDB¶

OpenTPV utiliza MariaDB como base de datos. Si ya tiene MariaDB instalado (versión 10.6 o superior), puede omitir este paso.

Descargar MariaDB¶

El instalador de OpenTPV incluye MariaDB. Si prefiere instalarlo por separado, descárguelo desde mariadb.org/download
Seleccione la versión 10.6 o superior para Windows

Proceso de instalación de MariaDB¶

Ejecute el instalador de MariaDB como administrador
Acepte los términos de la licencia
Seleccione la instalación Típica (recomendado)
En la pantalla de configuración:
Contraseña de root: Establezca una contraseña segura y anótela. La necesitará más adelante.
Puerto: Deje el valor predeterminado 3306 a menos que tenga otro servicio en ese puerto
Habilitar acceso remoto: Marque esta opción solo si usará OpenTPV en red con múltiples terminales
Marque la opción Instalar como servicio de Windows
Haga clic en Instalar y espere a que finalice

Configuración de MariaDB

⚠️ Advertencia: Guarde la contraseña de root en un lugar seguro. Sin ella no podrá configurar la conexión de OpenTPV a la base de datos.

Verificar que MariaDB está funcionando¶

Abra el Administrador de servicios de Windows (presione Win + R, escriba services.msc)
Busque el servicio MariaDB o MySQL
Verifique que el estado sea En ejecución

Paso 3: Instalar OpenTPV¶

Ejecutar el instalador¶

Localice el archivo del instalador (por ejemplo, OpenTPV-Setup-x.x.x.exe)
Haga clic derecho sobre el archivo → Ejecutar como administrador
Si Windows SmartScreen muestra una advertencia, haga clic en Más información → Ejecutar de todas formas

SmartScreen de Windows

Pantalla de bienvenida¶

Aparecerá la pantalla de bienvenida del instalador de OpenTPV
Haga clic en Siguiente para continuar

Pantalla de bienvenida del instalador

Acuerdo de licencia¶

Lea el acuerdo de licencia de usuario final (EULA)
Marque la casilla Acepto los términos del acuerdo de licencia
Haga clic en Siguiente

Selección de carpeta de instalación¶

La ruta predeterminada es C:\ProgramData\OpenX\OpenTPV
Puede cambiarla si lo necesita, pero se recomienda mantener la ruta por defecto
Haga clic en Siguiente

💡 Consejo: Si tiene múltiples discos, puede instalar en otro disco (por ejemplo D:\OpenTPV), pero la base de datos debería estar en un disco rápido (preferiblemente SSD).

Selección de componentes¶

El instalador le permitirá elegir qué componentes instalar:

Componente	Descripción	Recomendación
OpenTPV Core	Aplicación principal del punto de venta	Obligatorio
MariaDB	Motor de base de datos	Instalar si no lo tiene
.NET Framework 4.8	Entorno de ejecución	Instalar si no lo tiene
Controladores de impresora	Drivers para impresoras térmicas	Recomendado
Acceso directo en escritorio	Icono de acceso rápido	Opcional

Seleccione los componentes deseados y haga clic en Siguiente.

Selección de componentes

Progreso de la instalación¶

El instalador copiará los archivos necesarios
Este proceso puede tardar entre 2 y 10 minutos dependiendo de su equipo
No cierre la ventana ni apague el equipo durante la instalación

Progreso de instalación

Finalización¶

Cuando la instalación termine, verá la pantalla de finalización
Opcionalmente, marque Ejecutar OpenTPV ahora
Haga clic en Finalizar

Paso 4: Configurar el Firewall¶

Para que OpenTPV funcione correctamente, especialmente en configuraciones de red, debe agregar excepciones en el firewall.

Firewall de Windows¶

Abra Panel de Control → Sistema y Seguridad → Firewall de Windows Defender
Haga clic en Permitir una aplicación a través del Firewall
Haga clic en Cambiar configuración → Permitir otra aplicación
Busque y agregue:
C:\ProgramData\OpenX\OpenTPV\App\Latest\x86\OpenTPV.exe
El servicio de MariaDB (puerto TCP 3306)
Marque ambas casillas: Privada y Pública (si corresponde)

Antivirus de terceros¶

Si utiliza un antivirus diferente al de Windows:

Agregue la carpeta de instalación de OpenTPV a las exclusiones
Agregue el puerto 3306 (MariaDB) a las exclusiones de red
Consulte la documentación de su antivirus para instrucciones específicas

⚠️ Advertencia: Algunos antivirus pueden bloquear la comunicación entre OpenTPV y la base de datos. Si experimenta problemas de conexión, verifique las exclusiones del antivirus.

Paso 5: Verificar la Instalación¶

Iniciar OpenTPV por primera vez¶

Haga doble clic en el icono de OpenTPV en el escritorio, o búsquelo en el menú Inicio
La primera vez que inicie, el sistema puede tardar unos segundos adicionales mientras configura la base de datos
Si la instalación fue exitosa, verá la pantalla de Configuración Inicial (asistente de primer uso)

Asistente de configuración inicial

Verificar la conexión a la base de datos¶

Si OpenTPV no puede conectarse a la base de datos, mostrará un mensaje de error. En ese caso:

Verifique que el servicio de MariaDB esté en ejecución (ver Paso 2)
Confirme que la contraseña de root es correcta
Verifique que el puerto 3306 no esté bloqueado

Solución de Problemas de Instalación¶

Error: ".NET Framework no encontrado"¶

Solución: Descargue e instale .NET Framework 4.8 desde el sitio oficial de Microsoft. Reinicie el equipo e intente nuevamente.

Error: "No se puede conectar a la base de datos"¶

Solución: 1. Abra services.msc y verifique que MariaDB esté en ejecución 2. Intente conectarse manualmente con el cliente de MariaDB: mysql -u root -p 3. Si el servicio no inicia, revise los logs en C:\Program Files\MariaDB\data\

Error: "Acceso denegado" durante la instalación¶

Solución: Asegúrese de ejecutar el instalador como administrador (clic derecho → Ejecutar como administrador).

La instalación se congela o no avanza¶

Solución: 1. Cierre el instalador desde el Administrador de tareas 2. Reinicie el equipo 3. Desactive temporalmente el antivirus 4. Ejecute nuevamente el instalador como administrador

Windows SmartScreen bloquea el instalador¶

Solución: Haga clic en Más información y luego en Ejecutar de todas formas. El instalador de OpenTPV es seguro; esta advertencia aparece porque el archivo fue descargado de internet.

Siguiente Paso¶

Una vez completada la instalación, continúe con la Configuración Inicial para establecer los datos de su empresa, configurar la conexión al SII y preparar el sistema para su primer uso.

¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl