Para clientes existentes de la edición descargable: instala con el instalador automático (Windows, Mac o Linux) o manualmente en un servidor PHP/MySQL, actualiza con una copia de seguridad previa, restaura desde un archivo de respaldo, programa tus propias copias y haz accesible una instalación local por red o Internet.

PHP Point Of Sale es un servicio en la nube — te registras, recibes la URL de tu tienda y no se instala nada en tu equipo (mira ¿qué es PHP Point Of Sale?). Este artículo es documentación heredada para clientes que compraron la edición descargable en el pasado y la ejecutan en su propia computadora o servidor web. Si estás empezando de cero, usa la nube — comienza una prueba gratuita en lugar de instalar nada.

Tras una compra de descarga recibes por correo un enlace a la página de descargas. Esa página ofrece el instalador automático para cada plataforma y el paquete de instalación manual/código fuente (.zip). Si no encuentras el correo original, la página de descargas reenvía el enlace al escribir el correo con el que compraste.

Elige una ruta de instalación

• Instalador automático — la ruta más simple en una máquina dedicada con Windows, Mac o Linux (32 o 64 bits). El instalador monta toda la pila — servidor web, PHP, MySQL — y la aplicación por ti.
• Instalación manual en un servidor existente — sube el paquete de código fuente a un servidor web que ya administras (hosting compartido, VPS o en tu local), con PHP y MySQL/MariaDB disponibles.

Si no sabes cuál te conviene, contacta a soporte antes de empezar — hay ayuda remota en la página de soporte.

Requisitos del servidor (instalación manual)

La instalación manual necesita un servidor con:

• PHP 7.3 o más reciente
• MySQL 5 o superior (se recomienda 5.6.4 o más) o MariaDB
• Biblioteca de imágenes GD 2
• Extensiones php-xml y php-zip
• SoapClient (php-soap) — solo si usas el procesamiento de tarjetas Mercury/Vantiv (Worldpay)

Instalador automático

1. Descarga el instalador para tu sistema operativo desde tu página de descargas.
2. Ejecútalo — doble clic en Windows/Mac e ingresa el usuario/contraseña de tu computadora si lo pide. En Linux, ejecútalo desde una terminal:

   sudo chmod 755 INSTALLER.run
   sudo ./INSTALLER.run

   (reemplaza INSTALLER.run con el archivo que descargaste).

3. Sigue las indicaciones de cada paso — acepta la licencia, conserva o elige la ubicación de instalación y espera a que la pila termine.
4. Al completarse, se te dirige a la página de tu punto de venta. Guárdala en marcadores para encontrarla después, e inicia sesión con las credenciales de administrador mostradas o definidas durante la instalación.

Guarda en un lugar seguro el directorio de instalación y las contraseñas que muestre el instalador — las necesitarás para copias de seguridad y actualizaciones.

Notas:

• Para enviar correo (recibos, alertas de existencias) desde una instalación local, debes configurar Configuración → Ajustes del correo electrónico con un servidor de correo (como Gmail o el de tu proveedor de Internet) — una instalación local recién hecha no puede enviar correo por sí sola.
• Error de Windows "api-ms-win-crt-runtime-l1-1-0.dll is missing": instala la actualización de Microsoft Update for Universal C Runtime in Windows (artículo de soporte 2999226) y vuelve a ejecutar el instalador.

Actualizar o reinstalar con el instalador automático

Haz siempre primero una copia de seguridad (abajo). Luego ejecuta el instalador más nuevo en la misma máquina y sigue las indicaciones — si actualizas, solo asegúrate de que esté elegida la ruta correcta de tu PHP Point Of Sale existente; con la ubicación por defecto no necesitas cambiar nada.

Restaurar desde una copia durante la instalación

Al mudarte a una máquina nueva, o al recuperar una:

1. Coloca tu archivo .sql de respaldo en la computadora donde instalarás.
2. Ejecuta el instalador automático.
3. Cuando el instalador pregunte si quieres restaurar desde una copia de seguridad, elige que sí y navega hasta el archivo.

Todos tus datos se restauran como parte de esa instalación.

Instalación manual en un servidor existente

Esta sección es solo para instalaciones nuevas — para una instalación existente, salta a "Actualizar una instalación manual" más abajo.

1. Crea la base de datos

Servidores con cPanel:

1. Entra a cPanel y abre MySQL Databases (bases de datos MySQL).
2. Crea una base de datos nueva.
3. Baja a Add New User y crea un usuario de base de datos con una contraseña fuerte.
4. Agrega el usuario a la base de datos que acabas de crear.
5. Asigna todos los privilegios a ese usuario sobre la base de datos.

Servidores sin cPanel: abre phpMyAdmin (o la línea de comandos de mysql) y crea una base de datos nueva y vacía (por ejemplo pointofsale). phpMyAdmin confirma con "Database … has been created".

2. Sube el código

1. Descarga la instalación manual/código fuente (.zip) desde tu página de descargas.
2. Sube el zip a tu servidor y extráelo en la raíz web (public_html/www) o en un subdirectorio.
3. Renombra la carpeta extraída a algo corto, como pos.

3. Configura la conexión a la base de datos

1. En la carpeta de la aplicación, ve a application/config, encuentra database.php.tmpl y renómbralo (o cópialo) a database.php.
2. Abre database.php en un editor y modifica solo las líneas comentadas para que coincidan con lo que creaste:
   • hostname — tu servidor de base de datos, normalmente localhost o 127.0.0.1
   • username — el usuario de base de datos que creaste
   • password — la contraseña de ese usuario
   • database — el nombre de la base de datos que creaste
3. Confirma que dbdriver esté en mysqli (nota la i final) y deja intacta cualquier otra línea — incluido dbprefix (phppos_).
4. Guarda el archivo. Si tu administrador de archivos no guarda directamente, guárdalo localmente y vuelve a subirlo encima del original.

4. Ejecuta el asistente de instalación

1. Apunta un navegador a http://tu-servidor.com/pos/ (o donde lo hayas colocado; usa HTTPS si el sitio se sirve así).
2. Aparece la pantalla de instalación: haz clic en Instalar Base de Datos. El proceso puede tardar unos minutos — no refresques ni salgas de la página hasta que termine.
3. Pasa a la pantalla de inicio de sesión y entra con las credenciales por defecto: usuario admin, contraseña pointofsale.
4. Cambia esa contraseña de inmediato (menú de tu avatar → Editar perfil) y continúa con tu primer día: configuración de la tienda.

Restauración manual desde una copia

Para restaurar un respaldo en una instalación manual: sube el código y crea una base de datos vacía como arriba, y luego reemplaza el archivo database/database.sql dentro de la carpeta de la aplicación con tu archivo de respaldo. Navega a la URL del punto de venta y se te pedirá instalar — la instalación carga tu respaldo en lugar de un esquema en blanco. Puede tardar mucho con una base de datos grande; no lo interrumpas.

Actualizar una instalación manual

Haz siempre una copia de seguridad antes de actualizar.

1. Cierra sesión en PHP Point Of Sale.
2. Elimina por completo la carpeta antigua de la aplicación y sube en su lugar el código de la nueva versión. (Guarda antes una copia de tu application/config/database.php.)
3. Recrea application/config/database.php — renombra database.php.tmpl y vuelve a capturar tus datos de base de datos, o coloca tu copia guardada — y confirma que el controlador sea mysqli.
4. Navega a la URL de la aplicación. El sistema detecta que la base de datos necesita actualizarse y muestra el botón Actualización de Base de datos. Haz clic y permanece en la página hasta que termine — puede tardar; no refresques ni salgas.

Entre versiones, la edición descargable muestra el botón Buscar actualizaciones en la parte superior de Configuración, que te dice si hay una versión más nueva disponible.

Respalda una instalación autoalojada

En la edición descargable las copias de seguridad son tu responsabilidad:

• Desde la aplicación: Configuración → Copia de seguridad de base de datos descarga tu base de datos completa como archivo .sql — el mismo flujo descrito en copias de seguridad y tus datos. La página de información general también lista phpMyAdmin y la exportación del panel de control del hosting como alternativas.
• Programada, en la pila del instalador de Windows: crea un archivo backup.bat con una sola línea —

  C:\PHPPOS\mysql\bin\mysqldump.exe -u bn_phppos -pPASSWORDNOSPACES bitnami_phppos > C:\Users\Administrator\Desktop\backup.sql

  Reemplaza PASSWORDNOSPACES con la contraseña de base de datos que está en C:\phppos\apps\phppos\htdocs\application\config\database.php (sin espacio después de -p), y cambia la ruta de salida a donde quieras escribir la copia. Luego abre el Programador de tareas, elige Crear tarea básica, nómbrala, elige la frecuencia y la hora, selecciona Iniciar un programa, navega a tu backup.bat y finaliza. La copia correrá según el horario, y puedes ajustarla después en el Programador de tareas.

Haz accesible una instalación local por tu red o por Internet

Si instalaste en una computadora Windows local de tu tienda, otros dispositivos pueden usarla una vez que el cortafuegos permita conexiones:

1. Abre Panel de control → Sistema y seguridad → Firewall de Windows → Configuración avanzada.
2. Elige Reglas de entrada y luego Nueva regla.
3. Selecciona Puerto, asegúrate de que TCP esté seleccionado y especifica el puerto 80 (a menos que hayas elegido otro durante la instalación). Haz clic en Siguiente.
4. Elige Permitir la conexión. Para acceso por Internet, deja marcados los tres perfiles (Dominio, Privado, Público).
5. Nombra la regla (por ejemplo "php pos") y haz clic en Finalizar.

Después obtén el nombre de equipo de la computadora (Inicio → clic derecho en Equipo → Propiedades → nombre del equipo) o su dirección IPv4 (Conexiones de red → tu conexión activa → Estado → Detalles). Desde otro dispositivo de la red, navega a http://NOMBRE_DEL_EQUIPO o http://DIRECCION_IP. Prefiere el nombre de equipo — el router puede asignar una IP nueva en cualquier momento.

Para llegar a la instalación desde fuera de tu red, configura en tu router el reenvío de puertos hacia el puerto 80 y usa tu IP pública (encuéntrala en whatismyip.com). Los pasos varían según el router — es una configuración avanzada.

En macOS, permite el acceso en Preferencias del Sistema → Seguridad y privacidad → Firewall (desbloquea con el candado y permite la conexión, o desactiva el cortafuegos en la máquina servidor).

Si en cambio instalaste en un servidor web remoto, la sección de instalación manual de arriba ya aplica; si no puedes acceder a la aplicación, contacta a soporte.

Después de instalar

• Crea sucursales, cajas, impuestos y artículos con tu primer día: configuración de la tienda.
• El procesamiento de tarjetas sigue la misma configuración por sucursal que la nube — mira configurar el procesamiento de tarjetas.
• Para ayuda del día a día usa este centro de ayuda; para bloqueos de instalación usa soporte.

Preguntas frecuentes

¿Cuáles son las credenciales por defecto tras una instalación manual? Usuario admin, contraseña pointofsale. Cambia la contraseña inmediatamente después de tu primer inicio de sesión.

La página de instalación/actualización tarda muchísimo — ¿se trabó? Las bases de datos grandes tardan de verdad. No refresques ni salgas; interrumpir el asistente a medio proceso es como se rompen las instalaciones. Si da error, restaura tu copia y reintenta.

Veo una pantalla en blanco en lugar de la página de instalación. Revisa los requisitos del servidor (versión de PHP, php-xml, php-zip, GD2) y que application/config/database.php exista con credenciales correctas y el controlador mysqli.

¿Cómo muevo PHP Point Of Sale a una computadora nueva? Respalda la base de datos en la máquina vieja y luego ejecuta el instalador automático en la nueva eligiendo restaurar desde una copia de seguridad cuando lo pregunte, apuntando a tu archivo .sql.

Windows dice que falta api-ms-win-crt-runtime-l1-1-0.dll. Instala la actualización Universal C Runtime de Microsoft (KB2999226) y vuelve a ejecutar el instalador.

Perdí mi enlace de descarga. ¿Dónde consigo el software otra vez? Escribe tu correo de compra en la página de descargas y el enlace se reenvía.

¿Cómo actualizo sin perder mis datos? Tus datos viven en la base de datos, no en la carpeta de la aplicación. Respalda, reemplaza la carpeta de la aplicación con la nueva versión, restaura database.php y ejecuta el paso Actualización de Base de datos en pantalla. Nunca elimines ni reemplaces la base de datos misma durante una actualización.

¿La vieja edición descargable recibe las actualizaciones automáticas de la nube? No — en instalaciones autoalojadas las actualizaciones son manuales (vigila el botón Buscar actualizaciones en Configuración). Las actualizaciones automáticas son una de las razones para pasarse a la nube; mira actualizaciones y nuevas versiones.