Actualizar PrestaShop manualmente en cPanel | Guía Paso a Paso

Actualizar tu tienda PrestaShop es una de las tareas de mantenimiento más importantes para garantizar la seguridad, el rendimiento y la compatibilidad con los módulos y temas de tu eCommerce. Aunque el proceso pueda sonar técnico, con esta guía paso a paso para hacer una actualización manual desde cPanel, podrás realizarlo sin necesidad de ser un experto en desarrollo.

Vamos a verlo con calma. Recuerda siempre que una actualización manual te da control total sobre el proceso, pero requiere seguir cada paso al pie de la letra para evitar errores. ¡Empecemos!

¿Por qué actualizar PrestaShop manualmente?

Actualizar PrestaShop desde el panel de administración es la opción más cómoda, pero a veces falla por límites de tiempo de ejecución del servidor o problemas de memoria. La actualización manual desde cPanel es más fiable cuando:

Tu versión de PrestaShop es muy antigua (por ejemplo, 1.6 o inferior).
Tienes muchos productos o módulos que ralentizan el proceso automático.
Necesitas hacer una copia de seguridad completa antes de actualizar.
Quieres evitar errores de conexión o tiempo de espera.

Además, al hacerlo manualmente, aprendes mejor cómo funciona tu tienda y puedes detectar problemas antes de que afecten a tus clientes.

Requisitos previos antes de empezar

Antes de tocar nada, asegúrate de tener todo listo:

Acceso a cPanel: Necesitas usuario y contraseña de tu hosting.
Acceso FTP o al administrador de archivos de cPanel: Para subir y modificar archivos.
Acceso a phpMyAdmin: Para gestionar la base de datos si es necesario.
Conocimiento básico de archivos: Saber qué es la carpeta raíz de tu tienda.
Paciencia y una conexión estable: No tengas prisa.

[WARNING] No intentes actualizar sin hacer una copia de seguridad completa. Un error puede dejar tu tienda inaccesible. ¡Hazla siempre!

Paso 1: Haz una copia de seguridad completa desde cPanel

Este es el paso más importante. Una copia de seguridad te permite restaurar tu tienda si algo sale mal.

1.1. Respalda los archivos de tu tienda

Entra a cPanel con tus credenciales.
Busca la sección Archivos y haz clic en Administrador de Archivos.
Navega hasta la carpeta donde está instalada tu tienda (normalmente public_html o una subcarpeta como tienda).
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic en Comprimir y elige Zip. Dale un nombre como backup_prestashop_antes_actualizar.zip.
Una vez creado, descárgalo a tu computadora. No lo borres del servidor hasta que termines la actualización.

1.2. Respalda la base de datos

En cPanel, busca la sección Bases de Datos y haz clic en phpMyAdmin.
Selecciona la base de datos de tu tienda (la que usa PrestaShop).
Haz clic en la pestaña Exportar.
Elige el método Rápido y formato SQL. Luego haz clic en Continuar.
Guarda el archivo .sql en tu computadora.

[TIP] Guarda ambos respaldos en una carpeta segura. Si algo falla, podrás restaurar todo en minutos.

Paso 2: Descarga la última versión de PrestaShop

Ve al sitio oficial de PrestaShop y descarga la versión más reciente estable. Busca el archivo comprimido (.zip).

No descargues versiones beta o de desarrollo, solo las etiquetadas como "stable".
Si tu versión es muy antigua, puede que necesites actualizar primero a una versión intermedia. Consulta la documentación oficial.

Paso 3: Sube los archivos de la nueva versión a tu servidor

Ahora toca reemplazar los archivos antiguos con los nuevos. No te preocupes, tu configuración y datos se mantienen porque no tocaremos la base de datos ni la carpeta /img (aunque haremos una excepción).

3.1. Descomprime la nueva versión en tu computadora

Busca el archivo .zip descargado y extráelo en una carpeta temporal. Verás una carpeta llamada prestashop (o similar) con muchas subcarpetas.

3.2. Sube los archivos mediante FTP o el Administrador de Archivos

Opción A: Usando el Administrador de Archivos de cPanel

En cPanel, abre el Administrador de Archivos.
Ve a la carpeta raíz de tu tienda.
Haz clic en Subir y selecciona todos los archivos de la nueva versión (puedes subir el .zip completo y luego descomprimirlo allí).
Si subes el .zip, una vez subido, haz clic derecho sobre él y selecciona Extraer. Asegúrate de que los archivos se sobrescriban.

Opción B: Usando un cliente FTP (FileZilla, Cyberduck, etc.)

Conéctate a tu servidor usando las credenciales FTP de cPanel.
Navega a la carpeta raíz de tu tienda.
Arrastra todos los archivos de la nueva versión desde tu computadora al servidor.
Cuando te pregunte si quieres sobrescribir, elige Sobrescribir todos.

[INFO] Al subir los archivos, se reemplazarán los antiguos. No te preocupes, los archivos de configuración como config/settings.inc.php se conservan si no los borras. Pero por seguridad, no borres nada manualmente.

Paso 4: Ejecuta el script de actualización

Una vez que los archivos están en su lugar, toca iniciar el proceso de actualización.

Abre tu navegador y escribe la URL de tu tienda seguida de /install/upgrade/upgrade.php. Por ejemplo: https://tutienda.com/install/upgrade/upgrade.php
Si todo está correcto, verás una pantalla de bienvenida del asistente de actualización.
Sigue los pasos que te indica:
- Paso 1: Te mostrará la versión actual y la nueva. Haz clic en Siguiente.
- Paso 2: Revisa los requisitos del servidor. Si todo está en verde, continúa.
- Paso 3: El asistente hará una copia de seguridad automática de la base de datos (opcional, pero recomendable). Puedes dejarla activada.
- Paso 4: Se ejecutarán las actualizaciones de la base de datos. Espera a que termine.
- Paso 5: Finaliza la actualización. Verás un mensaje de éxito.

[WARNING] No cierres el navegador mientras se ejecuta el script. Puede tardar varios minutos dependiendo del tamaño de tu tienda. Si ves que se queda colgado, espera al menos 5 minutos antes de recargar.

Paso 5: Elimina la carpeta /install

Por seguridad, PrestaShop requiere que elimines la carpeta /install después de actualizar. Si no lo haces, la tienda no funcionará correctamente.

Desde el Administrador de Archivos de cPanel, ve a la carpeta raíz de tu tienda.
Busca la carpeta llamada install.
Haz clic derecho y selecciona Eliminar. Confirma la acción.

[TIP] Si quieres mantenerla por algún motivo, al menos renómbrala a install_old o algo similar. Pero lo mejor es borrarla.

Paso 6: Verifica que todo funcione

Ahora toca comprobar que tu tienda está operativa.

Accede a la URL de tu tienda. Deberías ver la página de inicio sin errores.
Entra al panel de administración (normalmente /admin o la URL que hayas configurado).
Revisa las secciones principales: productos, pedidos, módulos, temas.
Prueba a hacer un pedido de prueba (puedes usar modo mantenimiento para que no lo vean los clientes).
Si ves algún error, anótalo. Los más comunes son:
- Error 500: Problema con algún módulo o tema incompatible.
- Página en blanco: Puede deberse a un error de PHP. Revisa los logs de error en cPanel (sección Errores o Logs de errores).

Si todo funciona, ¡enhorabuena! Has actualizado PrestaShop manualmente.

Solución de problemas comunes

La tienda muestra un error después de la actualización

Causa: Módulos o temas desactualizados.
Solución: Desactiva todos los módulos no nativos desde el panel de administración. Si no puedes acceder, renombra la carpeta modules a modules_old y crea una nueva carpeta modules vacía. Luego ve reactivando uno por uno.

No puedo acceder al panel de administración

Causa: La URL del admin cambió o hay un error de sesión.
Solución: Revisa el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php (en versiones 1.7+). Busca la línea _COOKIE_KEY_ y asegúrate de que no se haya modificado. También puedes regenerar el acceso desde phpMyAdmin.

El script de actualización no se ejecuta

Causa: La carpeta /install no está presente o los archivos no se subieron correctamente.
Solución: Vuelve a subir la carpeta /install desde la nueva versión. Asegúrate de que el archivo upgrade.php esté en /install/upgrade/.

[WARNING] Si usas Syspanel (el panel de control que antes se llamaba HestiaCP y cuyo puerto de acceso es el 2106), el proceso es similar. Solo cambia que el acceso a archivos se hace desde el Administrador de Archivos de Syspanel o mediante FTP. Los pasos de copia de seguridad y actualización son idénticos.

Preguntas frecuentes (FAQ)

¿Puedo saltarme versiones intermedias?

No es recomendable. Si tienes PrestaShop 1.6 y quieres pasar a 1.7, primero debes actualizar a la última versión de 1.6, luego a 1.7. Saltar versiones puede causar errores en la base de datos.

¿Qué hago si mi hosting no me permite subir archivos grandes?

Puedes usar el Administrador de Archivos de cPanel para subir el .zip completo y luego extraerlo. También puedes dividir la subida en partes usando FTP.

¿Pierdo mis productos, clientes o pedidos al actualizar?

No, siempre que no borres la base de datos ni la carpeta /img. La actualización solo modifica archivos del sistema y la estructura de la base de datos, pero tus datos se conservan.

¿Cuánto tiempo tarda la actualización manual?

Depende del tamaño de tu tienda y la velocidad de tu servidor. Normalmente entre 15 y 45 minutos, incluyendo la subida de archivos.

¿Debo actualizar también los módulos y el tema?

Sí, después de actualizar PrestaShop, es recomendable actualizar todos los módulos y el tema a sus versiones compatibles. De lo contrario, pueden aparecer errores o incompatibilidades.

Conclusión

Actualizar PrestaShop manualmente desde cPanel es un proceso seguro si sigues los pasos con cuidado. La clave está en hacer una copia de seguridad completa, subir los archivos correctamente y ejecutar el script de actualización sin interrupciones. Una vez que lo hagas una vez, verás que no es tan complicado y te dará más control sobre tu eCommerce.

Recuerda que mantener tu tienda actualizada no solo mejora la seguridad, sino que también te da acceso a nuevas funcionalidades y mejoras de rendimiento. Si en algún momento te sientes perdido, no dudes en consultar la documentación oficial de PrestaShop o pedir ayuda a tu proveedor de hosting.

¡Buena suerte con tu actualización y que tu tienda siga creciendo!