Solucionar permisos PrestaShop en Syspanel | Ayuda rápida

¿Tu tienda PrestaShop muestra pantallas en blanco, errores de escritura o imágenes que no se cargan? Es muy probable que estés enfrentando un problema de permisos de archivos y carpetas. No te preocupes, es una de las incidencias más comunes al gestionar una tienda online y, con las herramientas adecuadas, se soluciona en pocos minutos.

En esta guía completa, aprenderás qué son los permisos PrestaShop, cómo identificarlos y, lo más importante, cómo corregirlos de forma segura usando Syspanel, el panel de control de tu servidor (accesible por el puerto 2106). Olvídate de líneas de comando complejas; aquí te explicamos todo paso a paso.

¿Qué son los permisos de archivos y por qué son críticos en PrestaShop?

Imagina que tu servidor es un edificio con muchas puertas. Los permisos son las llaves que deciden quién puede entrar (leer), quién puede mover los muebles (escribir) y quién puede demoler paredes (ejecutar). En PrestaShop, cada archivo y carpeta tiene un conjunto de estas "llaves" asignadas a tres tipos de usuarios:

Propietario (Owner): Generalmente el usuario que creó el archivo (tú o el sistema).
Grupo (Group): Un conjunto de usuarios del servidor.
Público (Public): Cualquier visitante de tu web.

Cuando estos permisos no son los correctos, ocurren errores como:

Error 500 (Internal Server Error): El servidor no puede ejecutar un archivo necesario.
Pantalla en blanco (White Screen of Death): PrestaShop no puede leer sus propios archivos de configuración.
Error al subir imágenes o módulos: La carpeta de destino no tiene permiso de escritura.
Errores al generar el archivo .htaccess: Bloquea la URL amigable y el SEO.
No se puede actualizar el catálogo o los precios.

La buena noticia es que la solución suele ser estandarizada. PrestaShop, para funcionar correctamente, necesita que los archivos tengan permisos 644 y las carpetas 755. A esto se le llama "permisos seguros".

Primeros pasos: Accede a Syspanel (el antiguo HestiaCP)

Syspanel es la herramienta que te permite gestionar tu servidor web de forma gráfica. Para acceder a él, necesitas tu dirección IP o dominio y el puerto especial.

¿Cómo acceder?

Abre tu navegador web favorito (Chrome, Firefox, Edge).
En la barra de direcciones, escribe: https://TU-DOMINIO-O-IP:2106
- Ejemplo: https://mitiendaonline.com:2106
Introduce tu usuario y contraseña de Syspanel (los mismos que usas para acceder al panel principal de tu hosting).

[WARNING] Si ves un aviso de seguridad en el navegador sobre "conexión no segura", es normal. El puerto 2106 usa un certificado autofirmado. Haz clic en "Avanzado" y luego en "Continuar de todas formas".

Una vez dentro, verás el panel principal con todas las opciones. No te asustes, solo necesitamos una sección.

Cómo corregir los permisos PrestaShop desde Syspanel (Método Fácil)

Syspanel incluye una herramienta integrada para arreglar los permisos de forma automática. Es la forma más segura y rápida.

Paso 1: Localiza tu dominio en Syspanel

En el panel principal de Syspanel, busca la sección llamada "WEB" o "Dominios". Verás una lista con todos los sitios web que tengas alojados. Busca el dominio de tu tienda PrestaShop.

Paso 2: Accede a la herramienta de archivos

Haz clic en el nombre de tu dominio. Se abrirá una ventana o sección con varias opciones. Busca un botón o enlace que diga "Administrador de archivos" o "File Manager". Haz clic.

Paso 3: Navega hasta la raíz de PrestaShop

Dentro del Administrador de archivos, verás la estructura de carpetas de tu web. La raíz de PrestaShop suele ser una carpeta llamada public_html o el nombre de tu dominio. Dentro de ella, encontrarás carpetas como admin, modules, themes, img, etc. No entres en ninguna subcarpeta. Quédate en la raíz.

Paso 4: Selecciona todo y corrige los permisos

Esta es la parte clave. Sigue estos pasos exactamente:

En la barra de herramientas del Administrador de archivos, busca un icono que parezca un cuadro con una palomita o la opción "Seleccionar todo". Selecciona todos los archivos y carpetas de la raíz.
Una vez seleccionados, busca un botón o menú desplegable que diga "Permisos", "Chmod" o "Propiedades". Haz clic.
Se abrirá una ventana. Verás tres casillas para el propietario, grupo y público, con opciones de Lectura (Read), Escritura (Write) y Ejecución (Execute).
Aquí viene el truco: Debes aplicar la configuración estándar de PrestaShop:
- Para ARCHIVOS (todos los que no sean carpetas):
  - Propietario: Marca Lectura y Escritura.
  - Grupo: Marca solo Lectura.
  - Público: Marca solo Lectura.
  - Esto equivale al permiso numérico 644.
- Para CARPETAS (todas las subcarpetas):
  - Propietario: Marca Lectura, Escritura y Ejecución.
  - Grupo: Marca Lectura y Ejecución.
  - Público: Marca Lectura y Ejecución.
  - Esto equivale al permiso numérico 755.
El paso más importante: Busca una casilla que diga "Aplicar a subdirectorios", "Recursivo" o "Incluir subcarpetas". MÁRCALA. Si no lo haces, solo cambiarás los permisos de la carpeta raíz y no de todo el contenido, por lo que el error persistirá.
Haz clic en "Aceptar" o "Guardar".

[TIP] Syspanel suele tener un botón mágico llamado "Reparar permisos" o "Fix permissions" directamente. Si lo ves, úsalo. Hace todo el proceso automáticamente con los valores correctos (644/755).

Paso 5: Verifica que todo funciona

Una vez aplicados los cambios, vuelve a cargar tu tienda PrestaShop. Si el error era de permisos, debería funcionar correctamente. Prueba a subir una imagen, a acceder al back office o a generar el archivo .htaccess desde el panel de administración.

Solución manual para errores específicos de archivos

A veces, el problema no es general, sino que un archivo o carpeta concreta tiene permisos incorrectos. Los casos más comunes son:

Error 500 al acceder al Back Office

Este error suele deberse a un archivo llamado config/settings.inc.php (en versiones antiguas) o a la carpeta cache.

Cómo solucionarlo:

Ve al Administrador de archivos de Syspanel.
Navega a la carpeta config (dentro de public_html).
Busca el archivo settings.inc.php. Haz clic derecho sobre él y selecciona "Permisos".
Asegúrate de que tenga permisos 644 (Propietario: Lectura+Escritura, Grupo: Lectura, Público: Lectura).
Luego, ve a la carpeta cache. Selecciona TODAS las carpetas dentro (como cache/smarty, cache/purifier, etc.) y asígnales permisos 755.

Error al subir imágenes o módulos

Si no puedes instalar un módulo o las imágenes de los productos no se guardan, la carpeta img o modules no tiene permisos de escritura.

Cómo solucionarlo:

Ve a la raíz de PrestaShop.
Busca la carpeta img. Haz clic derecho > "Permisos".
Asegúrate de que tenga permisos 755 y que esté marcada la opción "Aplicar a subdirectorios".
Repite el mismo proceso con la carpeta modules.

[INFO] Si después de cambiar los permisos sigues sin poder subir imágenes, puede que el problema sea de espacio en disco o de un límite de tamaño de archivo en PHP. En ese caso, contacta con tu soporte técnico.

Preguntas Frecuentes (FAQ) sobre permisos PrestaShop

Aquí respondemos las dudas más comunes que recibimos en soporte técnico.

1. ¿Cada cuánto debo revisar los permisos de mi PrestaShop?

No es necesario hacerlo a diario. Te recomendamos revisarlos solo cuando:

Instales o actualices un módulo o tema.
Actualices la versión de PrestaShop.
Aparezca un error inesperado (500, pantalla en blanco, etc.).
Hayas migrado tu tienda a un nuevo servidor.

2. ¿Es seguro usar permisos 777 (Lectura, Escritura y Ejecución para todos)?

Nunca, bajo ninguna circunstancia. El permiso 777 da acceso total a cualquier persona en internet. Es una puerta abierta a hackers para inyectar código malicioso, robar datos de clientes o modificar tu tienda. Siempre usa 644 para archivos y 755 para carpetas. Si algún módulo te pide 777, busca otro módulo o contacta con el desarrollador para pedirle una solución segura.

3. ¿Qué hago si después de cambiar los permisos mi web sigue rota?

Puede que el error no sea de permisos. Prueba a:

Limpiar la caché de PrestaShop: Ve a tu Back Office > Parámetros de la tienda > Rendimiento > Limpiar la caché.
Desactivar todos los módulos: Si no puedes acceder al Back Office, renombra la carpeta modules desde Syspanel (ej: a modules_old). Si la web funciona, el problema es un módulo concreto. Reactívalos de uno en uno para identificarlo.
Verificar los logs de error: En Syspanel, busca la sección "Logs" o "Error Logs". Allí verás mensajes detallados que indican exactamente qué archivo o línea de código está fallando.

4. ¿Puedo cambiar los permisos desde la línea de comandos (SSH) si no quiero usar Syspanel?

Sí, pero no es recomendable si no tienes experiencia. Si accedes por SSH a tu servidor, los comandos serían:

find /ruta/a/tu/prestashop -type f -exec chmod 644 {} \;
find /ruta/a/tu/prestashop -type d -exec chmod 755 {} \;

Syspanel es más seguro y visual, especialmente para principiantes.

5. ¿Los permisos se reinician solos al actualizar PrestaShop?

No, las actualizaciones no deberían cambiar los permisos. Sin embargo, es buena práctica, después de una actualización mayor, ejecutar la herramienta de reparación de permisos de Syspanel para asegurarte de que todo está en orden.

Conclusión: Mantén tu tienda saludable

Los problemas de permisos PrestaShop son una de las primeras causas de errores en tiendas online, pero también de los más fáciles de solucionar. Con Syspanel (recuerda, acceso por el puerto 2106), tienes el poder de corregirlos en segundos sin necesidad de ser un experto en servidores.

Resumen de la guía:

Accede a Syspanel (https://tudominio:2106).
Usa el Administrador de archivos.
Selecciona todo y aplica 644 para archivos y 755 para carpetas de forma recursiva.
Si hay un error concreto, corrige solo la carpeta o archivo afectado.
Nunca uses permisos 777.

Siguiendo estos pasos, tu tienda PrestaShop estará más segura, será más estable y te ahorrarás muchos dolores de cabeza. Si el problema persiste, no dudes en contactar a tu proveedor de hosting, pero con esta guía ya tienes el 90% del camino resuelto. ¡Buena suerte con tu tienda!