Permisos de archivos en PrestaShop: Guía para corregirlos (cPanel y Plesk)

¿Tu tienda PrestaShop muestra errores de permisos o simplemente no carga? Es uno de los problemas más comunes y, afortunadamente, uno de los más fáciles de resolver si sabes dónde mirar. Los permisos PrestaShop son reglas que indican quién (el servidor, tú, o los visitantes) puede leer, escribir o ejecutar cada archivo y carpeta de tu instalación.

Cuando estos permisos se desconfiguran, la tienda puede dar pantallazos blancos, errores de escritura en caché, imposibilidad de subir imágenes o, en el peor de los casos, un error 500. No te preocupes, no eres el único. A continuación, te explicamos paso a paso cómo diagnosticar y arreglar los errores permisos PrestaShop, tanto si usas cPanel como Plesk. Vamos a ello.

¿Por qué se rompen los permisos de archivos en PrestaShop?

Antes de lanzarnos a solucionar el problema, es útil entender por qué ocurre. PrestaShop necesita escribir archivos constantemente para funcionar: genera caché, guarda logs, sube imágenes de productos y actualiza su configuración.

Si tu servidor tiene una configuración incorrecta, o si has movido la tienda de hosting recientemente, los permisos se pueden resetear o quedar "mixtos". También es muy común que al descomprimir un backup desde tu ordenador local, los archivos hereden permisos de tu Mac o Windows, que no son compatibles con el servidor Linux.

[INFO] Los permisos se expresan en números (como 755 o 644). El primer número es para el usuario (tú), el segundo para el grupo (el servidor) y el tercero para el resto del mundo (visitantes). El 7 significa lectura + escritura + ejecución, el 5 es lectura + ejecución, y el 4 es solo lectura.

Requisitos previos y herramientas necesarias

Para arreglar los permisos archivos PrestaShop, necesitarás acceso a tu panel de control de hosting. Aquí te explicamos cómo hacerlo en los dos más populares: cPanel y Plesk.

Para cPanel: Tienes el Administrador de archivos integrado o puedes usar el cliente FTP (FileZilla es gratuito y perfecto para esto).
Para Plesk: La estructura es similar, con un administrador de archivos en el panel y soporte total para FTP.

[WARNING] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). La interfaz es distinta, pero la lógica de permisos es idéntica a la de cualquier servidor Linux.

Solución paso a paso para cPanel

Este es el método más directo si tu hosting usa cPanel. Vamos a usar el Administrador de Archivos, que es visual y no requiere programas externos.

1. Acceder al Administrador de Archivos

Entra en tu cPanel y busca la sección "Archivos". Haz clic en Administrador de Archivos. Se abrirá una ventana; selecciona la raíz del documento de tu tienda (normalmente public_html o una subcarpeta como public_html/prestashop).

2. Seleccionar todos los archivos y carpetas

Una vez dentro de la carpeta raíz de PrestaShop, debes seleccionar todo el contenido. Puedes hacer clic en el icono de selección múltiple (una casilla) o simplemente usar Ctrl + A (Cmd + A en Mac) para seleccionar todo.

3. Cambiar los permisos de carpetas (Directorios)

Con todo seleccionado, haz clic en el botón Permisos en la barra superior. Se abrirá una ventana emergente.

Marca la casilla que dice "Cambiar archivos y subdirectorios" o similar.
En el campo numérico, introduce 755 para los directorios.
Asegúrate de que la opción "Aplicar a directorios" esté marcada.

Haz clic en Guardar. Esto establecerá todos los directorios a 755.

4. Cambiar los permisos de archivos (Ficheros)

Repite el proceso de selección de todo (Ctrl + A), pero esta vez, en la ventana de Permisos, cambia el valor numérico a 644.

En la sección de opciones, busca la que dice "Aplicar solo a archivos" o "Aplicar a archivos".
Guarda los cambios.

[TIP] En cPanel, si no ves la opción de aplicar solo a archivos, hazlo en dos pasos: primero selecciona todo y aplica 755, luego deselecciona todo y aplica 644. El sistema te preguntará si quieres aplicar a todos los archivos dentro. Dile que sí.

5. Permisos especiales para la carpeta de caché y configuración

PrestaShop tiene carpetas que necesitan permisos de escritura más amplios para funcionar. Después de aplicar el 755/644 general, debemos ajustar algunas carpetas específicas a 755 (que ya lo están) pero asegurándonos de que el propietario es correcto. Si después de esto sigues teniendo errores, podemos probar con 757 temporalmente en estas carpetas:

/config
/cache
/var/cache (en versiones modernas)
/log
/img
/mails
/modules
/themes

[WARNING] No dejes los permisos en 777 (todos pueden escribir). Es un agujero de seguridad grave. Si necesitas usar 777 temporalmente para una instalación, cámbialo de vuelta a 755 inmediatamente después.

Solución paso a paso para Plesk

En Plesk, el proceso es igual de sencillo, aunque la interfaz cambia.

1. Usar el Administrador de archivos de Plesk

Entra en tu panel de Plesk y navega a Sitios web y dominios. Busca el dominio de tu tienda y haz clic en Administrador de archivos (suele tener un icono de carpeta).

2. Navegar a la raíz de PrestaShop

Dentro del administrador, ve a la carpeta httpdocs (esta es la raíz en Plesk, equivalente a public_html) y entra en la carpeta de PrestaShop.

3. Ajustar permisos de forma masiva

Plesk no tiene un botón tan directo como cPanel para aplicar a archivos y carpetas por separado. La forma más eficiente es usar la función de Cambiar permisos en la carpeta raíz.

Selecciona la carpeta principal de PrestaShop.
Haz clic en el icono de Permisos (en la barra de herramientas).
Marca la casilla "Cambiar los permisos de los archivos y subdirectorios".
Introduce 755 en el campo de permisos.
Pulsa Aceptar.

Esto pondrá todo a 755, lo cual es un buen punto de partida. Para ajustar los archivos a 644, tendrás que repetir el proceso pero usando la opción de "Filtrar" o haciendo una selección específica. En Plesk, la opción más fiable es hacerlo por FTP (FileZilla), que explicamos a continuación, ya que el administrador web a veces no diferencia bien.

[TIP] Plesk suele ser más estricto con el propietario de los archivos. Si después de cambiar a 755/644 sigues viendo errores, verifica que el usuario y grupo de los archivos sea www-data o el usuario del sistema que te indica Plesk en "Configuración de hosting".

La solución universal: Usar FTP (FileZilla)

Si los paneles de control te resultan confusos o no tienen las opciones claras, FileZilla es tu mejor aliado. Es gratuito y te da un control total.

1. Conectar con FileZilla

Abre FileZilla y conéctate a tu servidor usando las credenciales FTP que te proporcionó tu proveedor de hosting.

2. Seleccionar todo en el servidor

Navega hasta la carpeta raíz de PrestaShop. En el panel remoto (derecha), selecciona todos los archivos y carpetas (Ctrl + A).

3. Configurar los permisos de directorios

Haz clic derecho sobre la selección y elige "Permisos de archivo...".

En la ventana emergente, introduce 755 en el campo de valor numérico.
Marca la casilla "Aplicar a todos los archivos y directorios".
En la sección de abajo, elige "Solo directorios".
Pulsa Aceptar.

4. Configurar los permisos de archivos

Repite el proceso:

Selecciona todo de nuevo (Ctrl + A).
Haz clic derecho y ve a "Permisos de archivo...".
Introduce 644.
Marca "Aplicar a todos los archivos y directorios".
Elige "Solo archivos".
Pulsa Aceptar.

[INFO] El método de FileZilla es el más fiable porque te permite separar claramente entre archivos y carpetas, evitando errores comunes. Si FileZilla te da error de conexión, revisa que el puerto FTP (normalmente 21) esté abierto en tu firewall.

Errores comunes y cómo diagnosticarlos

A veces, incluso con los permisos correctos, PrestaShop da problemas. Aquí tienes una guía rápida para identificar el error.

Error 500 o pantalla blanca

Suele deberse a permisos incorrectos en /cache o /var/cache. Borra el contenido de estas carpetas (no las carpetas en sí) y vuelve a probar. Si el problema persiste, revisa los logs de error de PHP en el panel de control.

No puedo subir imágenes de productos

Esto indica que la carpeta /img o /upload no tiene permisos de escritura. Asegúrate de que estén en 755 y que el propietario sea el correcto.

Errores al instalar o desinstalar módulos

PrestaShop necesita escribir en /modules y /config. Si no puede, te dará un error de permisos. Asegúrate de que estas carpetas sean escribibles.

El back-office no carga, solo el front-office

Esto es típico de permisos incorrectos en /admin (tu carpeta de administración). Verifica que los archivos dentro de esa carpeta estén en 644 y las subcarpetas en 755.

Preguntas frecuentes (FAQ) sobre permisos PrestaShop

¿Qué permisos debe tener la carpeta config/settings.inc.php?
Este archivo es crítico. Debe tener permisos 644 o 444 (solo lectura). Si está en 777, es un riesgo de seguridad enorme. Si necesitas escribir en él (durante la instalación), usa 644 y luego bájalo a 444.

¿Por qué PrestaShop me pide permisos 777 en la instalación?
Durante la instalación, PrestaShop necesita crear archivos. Por eso pide permisos de escritura amplios. Una vez instalado, debes volver a 755/644. No dejes nunca 777.

¿Qué pasa si mi hosting usa Syspanel?
Como mencionamos antes, si tu panel es Syspanel (antes HestiaCP), el acceso es por el puerto 2106. La gestión de permisos se hace o bien desde su administrador de archivos o, más comúnmente, por FTP. Las reglas de 755/644 son exactamente las mismas.

¿Cada cuánto tiempo debo revisar los permisos?
No hay una regla fija. Te recomendamos revisarlos después de:

Migrar de hosting.
Instalar o actualizar PrestaShop.
Instalar módulos que modifiquen archivos del núcleo.

¿Puedo cambiar los permisos desde un plugin?
No es recomendable. Los plugins de permisos pueden ser útiles, pero es mejor hacerlo manualmente o con FTP para tener control total y saber exactamente qué se está cambiando.

Conclusión: Mantén tu tienda sana

Arreglar los permisos PrestaShop es una tarea de mantenimiento básico que deberías saber hacer. Con estos pasos para cPanel, Plesk o FTP, podrás resolver la mayoría de los problemas de "no carga", "no escribe" o "error 500" en unos minutos.

Recuerda la regla de oro: directorios en 755, archivos en 644. Solo varía de esta regla en casos muy específicos y temporales, como una instalación o una carpeta de caché con problemas puntuales. Si después de seguir todos estos pasos sigues teniendo errores permisos PrestaShop, el problema puede estar en el propietario de los archivos o en la configuración de PHP (modo CGI vs. módulo Apache). En ese caso, contacta con tu proveedor de hosting, ya que es un ajuste de servidor que ellos deben realizar.

Esperamos que esta guía te haya sido de ayuda. ¡Tu tienda volverá a funcionar en un abrir y cerrar de ojos!