Actualizar PrestaShop manualmente en DirectAdmin | Paso a paso

¿Por qué actualizar PrestaShop manualmente?

Actualizar PrestaShop es una tarea fundamental para mantener tu tienda online segura, rápida y compatible con las últimas tecnologías. Aunque PrestaShop ofrece actualizaciones automáticas mediante el módulo 1-Click Upgrade, a veces fallan por límites de servidor, módulos incompatibles o simplemente porque prefieres tener control total del proceso. La actualización manual en un panel como DirectAdmin te da esa seguridad y control.

Esta guía está pensada para ti, que eres un SysAdmin ecommerce o un usuario con conocimientos básicos de hosting. Vamos a ver paso a paso cómo actualizar PrestaShop manualmente en DirectAdmin, sin perder datos, sin romper la tienda y con la tranquilidad de tener un backup de respaldo.

[WARNING] Antes de comenzar: una actualización manual implica sobrescribir archivos del núcleo. Si no realizas una copia de seguridad completa, podrías perder tu tienda. No te saltes el paso del backup.

Requisitos previos

Antes de lanzarte a la actualización, asegúrate de cumplir con lo siguiente:

Acceso a DirectAdmin con permisos de administrador de dominio.
Conexión FTP/SFTP o acceso al Administrador de Archivos de DirectAdmin.
Conocimiento básico de cómo navegar por carpetas y subir archivos.
Tener a mano la versión actual de tu PrestaShop (puedes verla en el back office, en "Información del sistema").
Descargar la última versión estable de PrestaShop desde prestashop.com.
Un cliente FTP como FileZilla o WinSCP (opcional, pero recomendado).

[INFO] Si tu versión actual es muy antigua (por ejemplo, 1.6), puede que necesites hacer una migración escalonada (1.6 -> 1.7 -> 8.x). No intentes saltar de 1.6 a la última directamente.

Paso 1: Realizar una copia de seguridad completa

Este es el paso más importante. Sin backup, cualquier error puede ser fatal.

¿Qué debes respaldar?

Archivos del sitio: toda la carpeta donde está instalado PrestaShop (normalmente public_html o tienda).
Base de datos: la base de datos MySQL asociada a tu tienda.

Cómo hacer el backup en DirectAdmin

Accede a DirectAdmin con tu usuario y contraseña.
Ve a Administrador de Archivos (File Manager).
Selecciona la carpeta raíz de tu tienda (ej. public_html).
Haz clic en Comprimir y elige formato ZIP. Descarga el archivo a tu PC.

Para la base de datos:

En DirectAdmin, ve a MySQL Management.
Busca la base de datos de tu tienda (suele tener un nombre como usuario_prestashop).
Haz clic en phpMyAdmin y luego en Exportar.
Elige el método rápido y descarga el archivo .sql.

[TIP] Guarda ambos backups en una carpeta local con la fecha, por ejemplo: backup-prestashop-2025-04-10.

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

Ve al sitio oficial de PrestaShop y descarga el archivo ZIP de la última versión estable. No descargues versiones beta o release candidates para una tienda en producción.

Descomprime el ZIP en tu PC. Dentro encontrarás una carpeta con todos los archivos del núcleo.

[WARNING] No confundas la versión completa con el paquete de actualización. Necesitas la versión completa (full package), no el upgrade pack.

Paso 3: Poner tu tienda en modo mantenimiento

Antes de tocar archivos, debes evitar que los clientes accedan a la tienda mientras actualizas.

Accede al back office de PrestaShop (ej. tudominio.com/admin).
Ve a Parámetros de la tienda > General > Mantenimiento.
Activa el modo mantenimiento y guarda los cambios.

Si no puedes acceder al back office (por ejemplo, porque ya está roto), puedes activarlo manualmente:

Conéctate por FTP a tu servidor.
Busca el archivo /config/defines.inc.php.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true temporalmente para ver errores.
También puedes crear un archivo maintenance.php vacío en la raíz (aunque esto no siempre funciona en todas las versiones).

[INFO] Si no puedes activar el mantenimiento, al menos asegúrate de que el tráfico sea bajo (por ejemplo, hazlo de madrugada).

Paso 4: Subir los nuevos archivos (sobrescritura manual)

Este es el corazón de la actualización manual PrestaShop. Vas a sobrescribir los archivos antiguos con los nuevos.

Opción A: Usando FTP/SFTP (recomendado)

Conéctate a tu servidor con FileZilla o similar.
Navega a la carpeta raíz de tu tienda (ej. public_html).
Desde tu PC, abre la carpeta descomprimida de la nueva versión.
Selecciona TODOS los archivos y carpetas de la nueva versión (incluyendo admin, modules, themes, etc.).
Arrástralos a la carpeta remota. Cuando te pregunte por sobrescritura, elige "Sobrescribir todo".

Opción B: Usando el Administrador de Archivos de DirectAdmin

En DirectAdmin, ve a Administrador de Archivos.
Entra en la carpeta raíz de tu tienda.
Sube el archivo ZIP de la nueva versión (no descomprimido).
Una vez subido, selecciona el ZIP y haz clic en Extraer.
Cuando se extraiga, se te preguntará si quieres sobrescribir archivos existentes. Acepta.

[WARNING] No borres nada antes de sobrescribir. La actualización manual solo reemplaza archivos del núcleo, no toca tus configuraciones ni módulos (aunque algunos módulos pueden quedar obsoletos).

Paso 5: Ejecutar el script de actualización de PrestaShop

Una vez que los archivos están en su lugar, toca actualizar la base de datos.

Abre tu navegador y ve a: tudominio.com/install/upgrade/upgrade.php
- Si no existe esa ruta, prueba con tudominio.com/install/upgrade/upgrade.php?admin=1
Si todo está bien, verás una pantalla que te guiará en el proceso de actualización de la base de datos.
Sigue las instrucciones. Normalmente solo tienes que hacer clic en "Actualizar" y esperar.

[TIP] Si aparece un error de "token inválido", asegúrate de haber subido correctamente la carpeta /install (aunque después debes eliminarla por seguridad).

¿Qué hacer si no funciona el script?

Si no puedes acceder al script de actualización, puedes intentar:

Borrar la carpeta /var/cache (si existe) y recargar.
Verificar que los permisos de archivos sean correctos (644 para archivos, 755 para carpetas).
Revisar el archivo /config/settings.inc.php para asegurarte de que los datos de conexión a la base de datos son correctos.

Paso 6: Eliminar la carpeta /install por seguridad

Una vez que la actualización ha terminado, debes eliminar la carpeta /install del servidor. Si no lo haces, cualquier persona podría reinstalar tu tienda desde cero.

Conéctate por FTP o al Administrador de Archivos.
Busca la carpeta /install en la raíz de tu tienda.
Elimínala por completo.

[WARNING] No olvides este paso. Es una de las vulnerabilidades más comunes en PrestaShop.

Paso 7: Verificar que todo funciona

Después de la actualización, haz estas comprobaciones básicas:

Accede al back office: ve a tudominio.com/admin e inicia sesión.
Revisa la versión: en "Información del sistema" debe aparecer la nueva versión.
Navega por la tienda: visita la página principal, una categoría, un producto y el carrito.
Prueba el proceso de compra: aunque sea con un producto ficticio.
Revisa los módulos: algunos pueden necesitar actualización. Ve a "Módulos > Módulos instalados" y mira si hay alertas.

[INFO] Si algún módulo deja de funcionar, puedes desactivarlo temporalmente y buscar una versión compatible.

Paso 8: Desactivar el modo mantenimiento

Una vez que todo esté correcto, vuelve al back office y desactiva el modo mantenimiento. Tu tienda ya está disponible para los clientes.

Solución de problemas comunes (FAQ)

¿Qué hago si después de la actualización veo una pantalla en blanco?

Activa el modo debug temporalmente editando el archivo /config/defines.inc.php y cambiando _PS_MODE_DEV_ a true. Así verás el error exacto. Generalmente es por un módulo incompatible o por falta de memoria PHP.

¿Puedo actualizar de PrestaShop 1.6 a 1.7 manualmente?

Sí, pero es más complejo porque cambia la estructura de temas y módulos. Te recomiendo hacerlo en un entorno de pruebas primero. El proceso es similar, pero después deberás migrar el tema y los módulos.

¿Qué pasa si tengo módulos personalizados o de pago?

Los módulos de pago suelen tener versiones compatibles con la nueva versión. Antes de actualizar, verifica en la web del desarrollador. Si no hay actualización, considera reemplazarlo.

¿Es seguro actualizar manualmente en DirectAdmin?

Sí, siempre que sigas los pasos y tengas un backup. DirectAdmin no interfiere con el proceso, solo es el panel de control. La actualización manual es igual de segura que en cualquier otro hosting.

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

Depende del tamaño de tu tienda y de tu conexión. Subir archivos puede tomar de 5 a 30 minutos. El script de actualización de base de datos suele tardar entre 1 y 10 minutos.

Conclusión

Actualizar PrestaShop manualmente en DirectAdmin no es complicado si sigues una guía clara y tienes paciencia. La clave está en el backup, en sobrescribir correctamente los archivos y en verificar que todo funciona después. Como SysAdmin ecommerce, esta habilidad te dará control total sobre tu tienda y evitará dolores de cabeza con actualizaciones automáticas fallidas.

Recuerda: siempre haz backup antes de tocar nada, y si algo sale mal, puedes restaurar todo desde tu copia de seguridad. ¡Manos a la obra!

[TIP] Programa las actualizaciones en horas de bajo tráfico y mantén un registro de las versiones que has instalado. Así llevarás un control histórico de tu tienda.