Errores de permisos en PrestaShop con cPanel - Soluciones

Si tienes una tienda en PrestaShop alojada en un servidor con cPanel, es probable que en algún momento te hayas encontrado con el molesto error de pantalla blanca, problemas al subir imágenes, o la imposibilidad de instalar módulos y temas. En el 90% de los casos, la raíz del problema está en los permisos de archivos y carpetas. No te preocupes, es algo muy común y solucionable.

En esta guía extensa y detallada, aprenderás todo lo necesario para diagnosticar y solucionar los errores permisos PrestaShop desde tu panel de control cPanel. Vamos a explicarlo paso a paso, como si estuvieras al lado de nuestro técnico de soporte.

¿Qué son los permisos de archivos y por qué causan problemas en PrestaShop?

Imagina que tu servidor es un edificio de oficinas. Cada archivo (una foto de producto, un archivo PHP) y cada carpeta (como la de “módulos” o “temas”) tiene una puerta con una cerradura electrónica. Esa cerradura tiene tres tipos de llaves:

Propietario (User): El dueño del archivo, normalmente tu cuenta de cPanel.
Grupo (Group): Un conjunto de usuarios del servidor que pueden tener acceso.
Público (World/Others): Cualquier persona o proceso en internet.

A cada una de estas llaves se le asigna un permiso: Lectura (r), Escritura (w) y Ejecución (x). En PrestaShop, estos permisos deben ser muy específicos para que el sistema pueda leer las plantillas, escribir archivos de configuración (como settings.inc.php) y ejecutar el código PHP.

Cuando ves errores como “No se puede escribir en la carpeta cache”, “Error al subir una imagen” o “Módulo no se puede instalar”, es casi seguro que tienes permisos PrestaShop cPanel mal configurados. El sistema necesita poder escribir en ciertas carpetas para funcionar correctamente.

Primeros pasos: Accede a cPanel y al Administrador de Archivos

Antes de empezar a cambiar permisos, necesitas saber dónde hacerlo. Sigue estos pasos:

Accede a tu cPanel: Normalmente es tudominio.com/cpanel o tudominio.com:2083. Usa tu usuario y contraseña de hosting.
Busca el “Administrador de Archivos” (File Manager): Es un icono muy común, suele estar en la sección de “Archivos”.
Navega a tu tienda: Dentro del Administrador de Archivos, busca la carpeta public_html (o www). Ahí es donde está instalado PrestaShop. Haz clic en la carpeta de tu tienda (por ejemplo, public_html/mitienda).

¡Ya estás en el lugar correcto! Ahora vamos a solucionar los problemas.

Solución 1: Corregir los permisos de las carpetas y archivos principales (Método Manual)

Este es el método más seguro y común. Consiste en cambiar los permisos de las carpetas y archivos clave de PrestaShop. Es importante hacerlo en el orden correcto.

### Paso 1: Ajustar los permisos de las carpetas

Todas las carpetas de PrestaShop deben tener un permiso de 755 o 750 (755 es más común y suele funcionar mejor en la mayoría de los entornos cPanel).

¿Cómo hacerlo?

En el Administrador de Archivos, selecciona la carpeta raíz de tu tienda (por ejemplo, public_html o el nombre de tu tienda).
Haz clic derecho sobre ella y selecciona “Cambiar permisos” (Change Permissions).
Verás una ventana con tres columnas (User, Group, World) y tres casillas por columna (Read, Write, Execute).
Configúralo así:
- User (Propietario): Marca Read, Write y Execute.
- Group (Grupo): Marca Read y Execute (NO marques Write).
- World (Público): Marca Read y Execute (NO marques Write).
En la parte inferior, verás un número: 755.
IMPORTANTE: Marca la casilla que dice “Cambiar los permisos a todos los archivos y carpetas dentro de esta carpeta” (o similar). Esto aplicará el cambio a TODAS las subcarpetas.
Haz clic en “Cambiar permisos”.

[WARNING] ¡Cuidado! Si marcas la casilla de “cambiar a todos los archivos y carpetas”, también cambiarás los permisos de los archivos (como .php, .tpl, .jpg) a 755. Esto no es correcto para los archivos. Por eso, el siguiente paso es fundamental.

### Paso 2: Ajustar los permisos de los archivos

Los archivos (no las carpetas) deben tener un permiso de 644 o 640. El 644 es el estándar.

¿Cómo hacerlo?

Vuelve a la carpeta raíz de tu tienda en el Administrador de Archivos.
Haz clic en “Seleccionar todo” (Select All) en la barra de herramientas. Verás que se marcan todos los archivos y carpetas.
DESMARCA las carpetas. ¿Cómo? Normalmente, las carpetas tienen un icono de carpeta. Puedes hacer clic en la casilla de verificación de una carpeta para desmarcarla, pero es más fácil: busca la opción “Seleccionar tipo” (Select by type) o simplemente, mantén presionada la tecla Ctrl (Windows) o Cmd (Mac) y haz clic en todas las carpetas para desmarcarlas. Si hay muchas, otra opción es no usar “Seleccionar todo” y en su lugar, hacer clic en el botón “Seleccionar archivos” (solo archivos) si tu File Manager lo permite.
Una vez que solo tengas seleccionados los archivos (con extensión .php, .tpl, .css, .js, .jpg, etc.), haz clic derecho y elige “Cambiar permisos”.
Configúralo así:
- User (Propietario): Marca Read y Write.
- Group (Grupo): Marca solo Read.
- World (Público): Marca solo Read.
El número que se muestra debe ser 644.
Haz clic en “Cambiar permisos”.

¡Listo! Con estos dos pasos, has corregido los permisos generales de toda tu instalación de PrestaShop. Ahora, veamos los casos especiales.

Solución 2: Permisos especiales para archivos y carpetas críticas

Algunas partes de PrestaShop necesitan permisos de escritura (777) para funcionar correctamente, aunque esto es un riesgo de seguridad. Lo ideal es usar 755 para carpetas y 644 para archivos, pero hay excepciones que debes conocer.

### Archivo `settings.inc.php` (o `parameters.php` en versiones modernas)

Este archivo contiene la configuración de la base de datos. A veces, durante la instalación o actualización de módulos, PrestaShop necesita escribir en él.

Permiso recomendado: 644 (lectura/escritura para el propietario, solo lectura para grupo y mundo).
Si tienes problemas: Temporalmente, cámbialo a 644 (si está en 444, cámbialo a 644). Después de solucionar el problema, vuelve a dejarlo en 444 (solo lectura) por seguridad.

### Carpeta `cache`, `log` y `upload`

PrestaShop necesita escribir constantemente en estas carpetas para guardar imágenes temporales, archivos de caché y logs de errores.

Permiso recomendado: 755.
Si ves errores de escritura: Cámbialas temporalmente a 777 (todos los permisos). Una vez que el error desaparezca, vuelve a 755.
Cómo hacerlo en cPanel: Selecciona la carpeta cache, haz clic derecho > Cambiar permisos > Marca todas las casillas (User, Group, World) > Aceptar. Esto es 777. Luego, repite el proceso pero desmarca “Write” para Group y World, dejando solo Read y Execute para ellos (755).

### Carpeta `modules` y `themes`

Al instalar o actualizar módulos y temas, PrestaShop necesita escribir en estas carpetas.

Permiso recomendado: 755.
Solución para errores de instalación: Si un módulo no se instala, cambia temporalmente la carpeta modules a 777. Una vez instalado, vuelve a 755. Haz lo mismo con la carpeta themes si tienes problemas al cambiar de plantilla.

[TIP] Siempre que cambies un permiso a 777, hazlo solo el tiempo necesario para solucionar el error. Inmediatamente después, revierte a 755. Es una medida de seguridad básica.

Solución 3: Usar la herramienta de “Permisos de archivos” de PrestaShop (Back Office)

Si prefieres no tocar cPanel, PrestaShop tiene una herramienta interna que puede ayudarte a diagnosticar y, en algunos casos, corregir los permisos.

Accede a tu Back Office (ej: tudominio.com/admin1234).
Ve a Parámetros Avanzados > Información (o Información del sistema).
Busca la sección “Permisos de archivos” (File Permissions). Verás una lista de carpetas y archivos con un semáforo: verde (OK), naranja (Advertencia) o rojo (Error).
Si ves algo en rojo, la herramienta te indicará qué carpeta o archivo tiene problemas. Sin embargo, esta herramienta solo detecta, no corrige. Para corregir, tendrás que usar cPanel como te hemos explicado.

Preguntas Frecuentes (FAQ) sobre permisos PrestaShop cPanel

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

P: ¿Por qué después de cambiar permisos sigo viendo errores?

R: Es posible que no hayas aplicado los cambios recursivamente (a todas las subcarpetas y archivos). Asegúrate de marcar la casilla “Cambiar permisos a todos los archivos y carpetas dentro” cuando cambies permisos de carpetas. También, verifica que tu servidor no tenga un límite de archivos (inode) o que el dueño del archivo sea correcto (tu usuario de cPanel).

P: ¿Es seguro usar permisos 777 en todo?

R: No, absolutamente no. Es un grave error de seguridad. Cualquier persona en internet podría modificar tus archivos, inyectar código malicioso o borrar tu tienda. Solo usa 777 de forma temporal y en carpetas muy concretas como cache o upload.

P: He cambiado permisos y ahora mi web sale en blanco (pantalla blanca de la muerte).

R: Esto suele pasar si cambiaste los permisos de los archivos PHP a 755 o 777. Los archivos deben ser 644. Vuelve al paso 2 de la Solución 1 y asegúrate de que todos los archivos tengan permiso 644.

P: Mi hosting usa Syspanel (HestiaCP) en lugar de cPanel, ¿cómo lo hago?

R: No te preocupes. Si tu hosting usa Syspanel (el antiguo HestiaCP), el proceso es similar pero el acceso es diferente. Para acceder a tu panel, usa tudominio.com:2106. Una vez dentro, busca el “Administrador de Archivos”. El resto del proceso (cambiar permisos a 755 para carpetas y 644 para archivos) es exactamente igual que en cPanel. La lógica es la misma, solo cambia la interfaz.

P: ¿Cada cuánto debo revisar los permisos?

R: No es necesario que los revises a menudo. Normalmente, solo debes hacerlo cuando:

Instales un nuevo módulo o tema.
Actualices PrestaShop.
Veas errores al subir imágenes o al guardar configuraciones.
Después de un ataque o restauración de copia de seguridad.

Conclusión: Mantén tu tienda segura y funcionando

Solucionar los errores permisos PrestaShop es una de las habilidades más básicas pero importantes para cualquier dueño de una tienda online. Con cPanel, es un proceso sencillo si sigues los pasos correctos: carpetas a 755, archivos a 644, y permisos temporales 777 solo para carpetas críticas como cache o modules durante una instalación.

Recuerda que la seguridad es lo primero. No dejes nunca permisos abiertos (777) de forma permanente. Si después de seguir toda esta guía sigues teniendo problemas, es posible que el error esté en otra parte (como en el archivo .htaccess o en la configuración de PHP). En ese caso, no dudes en contactar a nuestro equipo de soporte técnico, estaremos encantados de ayudarte a revisar tu instalación paso a paso.

¡Tu tienda online te lo agradecerá!