Modo mantenimiento PrestaShop en Syspanel | Guía

¿Necesitas poner tu tienda PrestaShop en modo mantenimiento para hacer una actualización, aplicar cambios de diseño o solucionar un problema? Es una operación muy habitual y, si se hace desde el panel de control Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106), es rápida y segura. En esta guía te explico paso a paso cómo hacerlo, qué precauciones tomar y cómo salir del modo mantenimiento sin sobresaltos.

¿Qué es el modo mantenimiento en PrestaShop?

El modo mantenimiento es un estado especial en el que tu tienda PrestaShop se vuelve inaccesible para los clientes y visitantes habituales. En lugar de ver los productos y poder comprar, los usuarios se encuentran con una pantalla personalizada (o la pantalla por defecto) que indica que la tienda está en obras.

¿Para qué sirve?

Para actualizar PrestaShop a una versión más reciente.
Para instalar o desinstalar módulos que puedan afectar al front-end.
Para hacer cambios importantes en la plantilla o en la configuración.
Para solucionar errores sin que los clientes vean fallos.
Para migrar la tienda a otro servidor.

Cuando activas el modo mantenimiento, tú como administrador puedes seguir accediendo al back office y a la tienda si tienes la IP correcta autorizada. Es una forma de trabajar tranquilo mientras los visitantes ven un mensaje amigable.

¿Por qué usar Syspanel (HestiaCP) para configurarlo?

Syspanel es el panel de control de tu servidor, que te permite gestionar archivos, bases de datos, dominios y mucho más. Accedes a él a través de https://tudominio.com:2106. Desde Syspanel puedes modificar directamente los archivos de configuración de PrestaShop sin necesidad de entrar al back office.

Ventajas de hacerlo desde Syspanel:

Si el back office no responde (por ejemplo, tras una actualización fallida), puedes seguir accediendo a los archivos.
Es más rápido que navegar por los menús de PrestaShop.
Te permite forzar el modo mantenimiento incluso si el sistema de PrestaShop está bloqueado.

Requisitos previos

Antes de empezar, asegúrate de tener:

Acceso a Syspanel (usuario y contraseña de tu hosting).
Conocimiento básico de cómo navegar por el gestor de archivos de Syspanel.
Tu IP pública anotada (para poder acceder tú a la tienda en modo mantenimiento).
Una copia de seguridad reciente de tu tienda (archivos y base de datos). Nunca está de más.

[WARNING] Si no tienes tu IP, puedes visitar sitios como “cuál es mi IP” y copiarla. Si tu IP cambia (por ejemplo, porque trabajas desde casa con IP dinámica), deberás actualizarla después.

Paso a paso: Configurar el modo mantenimiento desde Syspanel

1. Accede a Syspanel

Abre tu navegador y escribe:
https://tudominio.com:2106
Sustituye tudominio.com por tu dominio real. Introduce tu usuario y contraseña de Syspanel.

Si es la primera vez, verás el panel principal con iconos para gestionar bases de datos, dominios, etc.

2. Localiza el archivo de configuración de PrestaShop

PrestaShop guarda la configuración del modo mantenimiento en el archivo parameters.php, que se encuentra en la carpeta app/config de tu instalación.

Desde Syspanel:

Haz clic en "Archivos" o "File Manager" (depende de la versión).
Navega hasta la carpeta de tu sitio web. Normalmente está en home/nombredeusuario/web/tudominio/public_html.
Dentro de public_html, entra en la carpeta app y luego en config.
Busca el archivo parameters.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".

[TIP] Si no ves el archivo, asegúrate de tener activada la opción "Mostrar archivos ocultos" en el gestor de archivos de Syspanel.

3. Modifica los parámetros del modo mantenimiento

Dentro del archivo parameters.php, busca una sección que se parezca a esta (puede variar ligeramente según la versión de PrestaShop):

'parameters' => [
    'database_host' => 'localhost',
    // ... muchas líneas ...
    'maintenance' => false,
    'maintenance_ip' => ['127.0.0.1'],
    // ...
],

Lo que debes cambiar:

'maintenance' => false, → cámbialo a 'maintenance' => true,
'maintenance_ip' => ['127.0.0.1'], → añade tu IP real entre las comillas. Por ejemplo: 'maintenance_ip' => ['127.0.0.1', '123.456.789.0'], (sustituye 123.456.789.0 por tu IP).

Ejemplo completo de cómo debe quedar:

'maintenance' => true,
'maintenance_ip' => ['127.0.0.1', '85.12.34.56'],

[INFO] La IP 127.0.0.1 es la del propio servidor. No la borres. Añade tu IP después, separada por coma. Si tienes varias IPs (por ejemplo, la de tu casa y la de tu móvil), añádelas todas.

4. Guarda los cambios

Una vez modificado, haz clic en "Guardar" o "Save". Syspanel te pedirá confirmación. Acepta.

5. Verifica que el modo mantenimiento está activo

Abre una ventana de incógnito en tu navegador o usa otro dispositivo que no tenga tu IP. Visita tu tienda (https://tudominio.com). Deberías ver la pantalla de mantenimiento de PrestaShop.

Si accedes desde tu IP (la que añadiste), verás la tienda normalmente.

[WARNING] Si ves un error 500 o la página en blanco, revisa que no hayas borrado alguna coma o comilla en el archivo parameters.php. Si el error persiste, restaura la copia de seguridad o cambia 'maintenance' a false para desactivarlo.

Cómo personalizar la pantalla de mantenimiento

Puedes cambiar el mensaje que ven los visitantes. Para ello:

Ve al back office de PrestaShop (si puedes acceder).
Ve a Parámetros de la tienda > General > Mantenimiento.
Ahí puedes activar/desactivar, añadir tu IP y escribir un mensaje personalizado.

Si no puedes acceder al back office, puedes editar el archivo themes/tu_tema/modules/ps_mainmenu/ps_mainmenu.tpl o crear un archivo maintenance.tpl en la raíz de tu tema, pero es más avanzado. Lo recomendable es hacerlo desde el back office.

Cómo desactivar el modo mantenimiento

Cuando termines tus tareas, sigue estos pasos:

Vuelve a Syspanel y edita parameters.php.
Cambia 'maintenance' => true, a 'maintenance' => false,.
Guarda el archivo.
Visita tu tienda desde una ventana normal para comprobar que funciona.

[TIP] No olvides borrar tu IP de la lista maintenance_ip si ya no la necesitas, aunque no es obligatorio. Si la dejas, no pasa nada, solo que tú seguirías teniendo acceso aunque el modo esté desactivado.

Preguntas frecuentes (FAQ)

¿Puedo activar el modo mantenimiento desde el back office en lugar de Syspanel?

Sí, es más sencillo. Ve a Parámetros de la tienda > General > Mantenimiento y actívalo. Pero si el back office no carga, Syspanel es tu salvación.

¿Qué hago si no encuentro el archivo parameters.php?

Asegúrate de que estás en la carpeta correcta (public_html/app/config). Si usas una instalación personalizada, puede estar en otra ruta. También puedes buscar desde el gestor de archivos de Syspanel usando el buscador (lupa).

¿Se puede activar el modo mantenimiento sin editar archivos?

Sí, mediante FTP o SSH, pero Syspanel es más visual y seguro para usuarios no técnicos.

¿Pierdo ventas si activo el modo mantenimiento?

Sí, durante el tiempo que esté activo no podrás recibir pedidos. Por eso es mejor hacerlo en horas de baja actividad y avisar con antelación si es posible.

¿El modo mantenimiento afecta al SEO?

Sí, Google puede ver la página de mantenimiento y, si está mucho tiempo, podría interpretar que la tienda está caída. Lo ideal es no tenerlo activo más de unas horas. Puedes usar la cabecera HTTP 503 (Service Unavailable) que PrestaShop aplica automáticamente en modo mantenimiento para que los buscadores sepan que es temporal.

¿Puedo permitir el acceso a varios usuarios?

Sí, añade sus IPs en el array maintenance_ip separadas por comas. Por ejemplo: ['127.0.0.1', 'IP1', 'IP2'].

¿Qué pasa si olvido mi IP?

Puedes usar un servicio online para conocer tu IP pública. Si trabajas desde una red con IP dinámica, anótala cada vez que te conectes o usa una IP fija (por ejemplo, una VPN corporativa).

Consejos adicionales para una actualización segura

Si vas a actualizar PrestaShop, además del modo mantenimiento, ten en cuenta:

Haz una copia de seguridad completa (archivos + base de datos) antes de nada.
Desactiva todos los módulos no esenciales.
Usa la herramienta de actualización de PrestaShop (1-Click Upgrade) o el asistente manual.
Prueba en un entorno de staging si es posible.
Revisa los requisitos del servidor (versión de PHP, memoria, etc.).
Después de actualizar, comprueba que todo funciona: productos, carrito, pago, envío, etc.

[INFO] Syspanel también te permite gestionar copias de seguridad desde el panel. Úsalo para tener un respiro.

Conclusión

Configurar el modo mantenimiento de PrestaShop desde Syspanel es una habilidad básica pero muy valiosa para cualquier administrador de tiendas online. Te permite trabajar con tranquilidad, evitar errores visibles para los clientes y resolver problemas incluso cuando el back office no responde.

Recuerda:

Accede a Syspanel por el puerto 2106.
Edita el archivo parameters.php en app/config.
Cambia maintenance a true y añade tu IP.
Guarda y verifica.
Cuando termines, vuelve a ponerlo en false.

Con esta guía, ya puedes mantener tu PrestaShop offline de forma controlada y profesional. Si tienes dudas, repasa los pasos o consulta la documentación oficial de PrestaShop y Syspanel. ¡Buena suerte con tus actualizaciones!