Actualizar PrestaShop en Syspanel: Tutorial paso a paso

Mantener tu tienda PrestaShop actualizada es una de las tareas más importantes para garantizar su seguridad, rendimiento y compatibilidad con los últimos módulos y temas. Si tu tienda está alojada en un servidor que utiliza Syspanel (anteriormente conocido como HestiaCP, accesible por el puerto 2106), este proceso puede realizarse de forma segura siguiendo unos pasos claros.

En esta guía te explicaremos, paso a paso, cómo realizar una actualizar PrestaShop Syspanel de manera manual, evitando errores comunes y protegiendo tus datos.

¿Por qué es importante actualizar PrestaShop?

Antes de comenzar, es fundamental entender los motivos por los que debes mantener tu tienda al día:

Seguridad: Cada nueva versión corrige vulnerabilidades conocidas. No actualizar expone tus datos y los de tus clientes.
Rendimiento: Las versiones más recientes suelen incluir mejoras de velocidad y optimización de recursos.
Compatibilidad: Módulos y temas de terceros se diseñan para funcionar con las últimas versiones.
Funcionalidades: Accedes a nuevas herramientas y mejoras en la gestión de tu tienda.

Requisitos previos para la actualización

Antes de lanzarte a la Syspanel actualización PrestaShop, asegúrate de cumplir con estos requisitos:

1. Verifica la versión actual de PrestaShop

Accede a tu panel de administración de PrestaShop y, en la página principal del panel, busca el número de versión (normalmente en la esquina inferior derecha). Anótalo.

2. Comprueba los requisitos de la nueva versión

Visita la página oficial de descargas de PrestaShop y revisa los requisitos técnicos de la versión a la que deseas migrar (PHP, MySQL, memoria, etc.). Si tu servidor no los cumple, deberás actualizar primero el entorno.

3. Haz una copia de seguridad COMPLETA

Este es el paso más crítico. Utiliza Syspanel para generar una copia de seguridad de tu sitio web y base de datos. Para ello:

Inicia sesión en Syspanel a través de https://tudominio.com:2106.
Ve a la sección Backup.
Selecciona tu dominio y elige Backup completo (sitio web + base de datos).
Descarga el archivo generado y guárdalo en un lugar seguro fuera del servidor.

[WARNING] No omitas este paso. Una copia de seguridad te permitirá restaurar tu tienda en caso de cualquier error durante la actualización.

4. Pon tu tienda en modo mantenimiento

Desde el panel de administración de PrestaShop:

Ve a Parámetros de la tienda > Mantenimiento.
Activa el modo mantenimiento.
Opcionalmente, puedes añadir una IP de confianza para que tú puedas acceder mientras tanto.

Método 1: Actualización manual desde Syspanel (recomendado para versiones recientes)

Este método es el más seguro y recomendado para actualizar PrestaShop Syspanel sin complicaciones.

Paso 1: Descarga la nueva versión de PrestaShop

Desde la web oficial de PrestaShop, descarga el paquete completo de la última versión estable (archivo .zip o .tar.gz).

Paso 2: Sube los archivos a tu servidor mediante Syspanel

Accede a Syspanel y ve a File Manager.
Navega hasta la carpeta public_html de tu dominio.
Sube el archivo comprimido que descargaste.
Una vez subido, haz clic derecho sobre él y selecciona Extraer (o descomprimir). Si no tienes esta opción, puedes usar la terminal (ver método alternativo).

Paso 3: Reemplaza los archivos (con cuidado)

Importante: No sobrescribas los archivos de configuración personalizados ni la carpeta /img ni /themes (a menos que sepas lo que haces). La forma más segura es:

En el File Manager, selecciona todos los archivos de la nueva versión descomprimida.
Cópialos y pégalos en la raíz de tu tienda (generalmente public_html), permitiendo sobrescribir los archivos existentes.
No sobrescribas los archivos config/settings.inc.php (o app/config/parameters.php en PrestaShop 1.7+), ni la carpeta /img, ni /themes (a menos que uses el tema por defecto).

[TIP] Si usas un tema personalizado, antes de sobrescribir, haz una copia de la carpeta /themes/tunombre. Luego, tras la actualización, comprueba si el tema es compatible con la nueva versión.

Paso 4: Ejecuta el script de actualización automática

Desde tu navegador, accede a https://tudominio.com/install/upgrade/upgrade.php.
Sigue las instrucciones en pantalla. El script comprobará la versión actual y aplicará los cambios necesarios en la base de datos.
Si todo va bien, verás un mensaje de éxito.

Paso 5: Elimina la carpeta /install

Por seguridad, después de la actualización, elimina la carpeta /install del servidor. Puedes hacerlo desde el File Manager de Syspanel.

Paso 6: Desactiva el modo mantenimiento y prueba

Vuelve al panel de administración de PrestaShop y desactiva el modo mantenimiento. Recorre tu tienda como cliente para verificar que todo funciona correctamente: productos, carrito, checkout, etc.

Método 2: Actualización mediante la terminal de Syspanel (para usuarios avanzados)

Si te sientes cómodo con la línea de comandos, este método es más rápido.

Paso 1: Conecta por SSH a tu servidor

Usa un cliente como PuTTY o Terminal. Tus credenciales SSH las encuentras en Syspanel > Advanced > SSH Access.

Paso 2: Navega a la raíz de tu tienda

cd /home/usuario/web/tudominio/public_html

Paso 3: Descarga la nueva versión

wget https://github.com/PrestaShop/PrestaShop/releases/download/8.2.0/prestashop_8.2.0.zip

Ajusta la URL a la última versión disponible.

Paso 4: Descomprime y reemplaza

unzip prestashop_8.2.0.zip
cp -r prestashop/* ./
rm -rf prestashop prestashop_8.2.0.zip

Paso 5: Ejecuta el script de actualización

Accede a https://tudominio.com/install/upgrade/upgrade.php desde tu navegador.

Paso 6: Limpieza final

rm -rf install

Preguntas frecuentes (FAQ)

¿Puedo actualizar PrestaShop directamente desde la versión 1.6 a la 8.x?

No es recomendable. Debes hacer actualizaciones intermedias: primero a 1.7.x, luego a 8.x. O bien, usar el módulo 1-Click Upgrade que a veces lo gestiona automáticamente, pero con riesgo.

¿Qué hago si la actualización falla?

Restaura la copia de seguridad que realizaste al inicio desde Syspanel > Backup > Restore. Luego, revisa los logs de error en /var/log/ o en la carpeta /app/logs de PrestaShop.

¿El módulo 1-Click Upgrade funciona en Syspanel?

Sí, pero a veces puede dar problemas de permisos. Si lo usas, asegúrate de que los permisos de archivos y carpetas sean correctos (755 para carpetas, 644 para archivos). Puedes ajustarlos desde el File Manager de Syspanel.

¿Cómo sé si mi hosting con Syspanel soporta la nueva versión de PrestaShop?

Revisa la versión de PHP y MySQL en Syspanel > Advanced > PHP Settings. PrestaShop 8 requiere PHP 8.0 como mínimo. Si tu versión es inferior, deberás actualizar PHP primero desde el mismo panel.

¿Pierdo mis módulos y temas al actualizar?

No deberías, pero algunos módulos o temas antiguos pueden ser incompatibles. Es recomendable desactivarlos temporalmente antes de la actualización y luego ir activándolos uno a uno.

Consejos finales para una actualización exitosa

Realiza la actualización en un entorno de pruebas si es posible. Muchos planes de Syspanel permiten crear subdominios o cuentas adicionales para pruebas.
No actualices en horas punta de ventas. Elige un momento de bajo tráfico.
Actualiza también los módulos después de la actualización principal. Ve a Módulos > Módulos y servicios y comprueba las actualizaciones disponibles.
Revisa el archivo .htaccess después de la actualización. PrestaShop suele regenerarlo, pero si tienes reglas personalizadas, asegúrate de que se mantienen.

[INFO] Si después de la actualización ves errores de "500 Internal Server Error", revisa los logs de error del servidor en Syspanel > Advanced > Error Log. Suele ser un problema de permisos o de un módulo incompatible.

Actualizar PrestaShop a una nueva versión en Syspanel no tiene por qué ser un dolor de cabeza si sigues estos pasos con calma y siempre con una copia de seguridad a mano. Recuerda que la seguridad de tu tienda y la confianza de tus clientes dependen de mantener el software actualizado.

Si durante el proceso te surge alguna duda, no dudes en contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte a que tu tienda siga funcionando sin problemas!