Permisos de archivos en PrestaShop | Solución

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con pantallas en blanco, errores al subir imágenes, problemas para escribir en la carpeta cache o mensajes extraños al intentar actualizar un módulo. Todos estos síntomas apuntan a un mismo culpable: permisos de archivos incorrectos.

En PrestaShop, cada archivo y carpeta tiene un conjunto de permisos que determinan quién puede leer, escribir o ejecutar. Cuando estos valores no coinciden con los que el servidor espera, la tienda falla. Lo bueno es que es un problema con solución y en esta guía te voy a enseñar a corregirlo paso a paso en los tres paneles de control más comunes: cPanel, Plesk y DirectAdmin.

No necesitas ser un experto en Linux ni en línea de comandos. Solo sigue las instrucciones al pie de la letra y en menos de 15 minutos tu tienda debería volver a funcionar con normalidad.

Entendiendo los permisos de archivos en PrestaShop

Antes de lanzarnos a cambiar valores, es fundamental que entiendas qué significan esos números raros que verás (como 644 o 755). No te asustes, es más sencillo de lo que parece.

Cada archivo tiene tres grupos de permisos:

Propietario (owner): normalmente es el usuario que creó el archivo o el usuario del FTP.
Grupo (group): un conjunto de usuarios que pueden tener acceso compartido.
Otros (others): cualquier persona que acceda al servidor.

Y para cada grupo hay tres acciones posibles:

Lectura (r): valor 4.
Escritura (w): valor 2.
Ejecución (x): valor 1.

Cuando ves un número como 755, se desglosa así:

7 para el propietario (4+2+1 = lectura, escritura y ejecución).
5 para el grupo (4+1 = lectura y ejecución).
5 para otros (4+1 = lectura y ejecución).

En PrestaShop, los valores recomendados suelen ser:

Archivos: 644 (el propietario lee y escribe; el grupo y otros solo leen).
Carpetas: 755 (el propietario tiene control total; el resto solo lee y ejecuta).

Ahora bien, hay ocasiones en que necesitas permisos más flexibles, como 777 para carpetas temporalmente (por ejemplo, cache, var/cache o img). Pero ojo, no es buena práctica dejarlos así permanentemente porque supone un riesgo de seguridad. Úsalos solo para solucionar el problema y luego vuelve a los valores estándar.

Solución de permisos en cPanel

cPanel es uno de los paneles más populares en el hosting compartido. Si tu proveedor lo usa, sigue estos pasos:

Paso 1: Accede al Administrador de Archivos

Entra en tu cPanel (normalmente en tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Administrador de Archivos.
Se abrirá una ventana; selecciona la raíz del documento (suele ser public_html o www) y haz clic en Ir.

Paso 2: Cambia los permisos de una carpeta completa

Dentro del Administrador de Archivos, navega hasta la raíz de tu PrestaShop (donde están las carpetas img, var, config, etc.).
Selecciona todas las carpetas y archivos (puedes usar Ctrl+A o el botón Seleccionar todo).
Haz clic en el botón Permisos (arriba en la barra de herramientas).
Se abrirá una ventana con casillas. Marca las opciones para que queden así:
- Propietario: Lectura, Escritura y Ejecución (7).
- Grupo: Lectura y Ejecución (5).
- Otros: Lectura y Ejecución (5).
Haz clic en Cambiar permisos.

[WARNING] Este método cambia los permisos de todo lo que hayas seleccionado. Asegúrate de no incluir archivos fuera de la raíz de PrestaShop, o podrías dejar tu sitio vulnerable.

Paso 3: Corrige los archivos individualmente

En PrestaShop, hay algunos archivos que necesitan permisos especiales, como config/settings.inc.php (en versiones antiguas) o los archivos dentro de app/config/parameters.php. Para estos:

Localiza el archivo en cuestión.
Haz clic derecho sobre él y selecciona Permisos.
Cámbialo a 644 (o 444 si el servidor te da problemas de escritura, pero no es recomendable).

Paso 4: Usa el instalador de PrestaShop para reparar permisos

Si prefieres no hacerlo manualmente, PrestaShop tiene una herramienta integrada:

Ve a tu panel de administración (tudominio.com/admin123 o la URL que hayas configurado).
Navega a Parámetros avanzados > Información.
Busca la sección Permisos de archivos. Te mostrará en verde o rojo el estado de cada carpeta.
Si algo está en rojo, PrestaShop te dará la opción de Arreglar automáticamente. Haz clic en ello.

Este método es el más seguro porque solo toca lo que realmente necesita cambios.

Solución de permisos en Plesk

Plesk tiene un enfoque ligeramente distinto, pero igual de sencillo. Aquí te explico cómo hacerlo:

Paso 1: Accede al Administrador de archivos de Plesk

Entra en tu Plesk (normalmente en tudominio.com:8443).
Ve a Sitios web y dominios.
En el dominio donde está PrestaShop, haz clic en Administrador de archivos (icono de carpeta).

Paso 2: Cambia los permisos de manera visual

Navega hasta la raíz de PrestaShop.
Selecciona todas las carpetas y archivos.
Haz clic en el botón Permisos (icono de candado o llave).
Se abrirá una ventana con casillas de verificación. Marca:
- Propietario: Lectura, Escritura y Ejecución.
- Grupo: Lectura y Ejecución.
- Otros: Lectura y Ejecución.
Aplica los cambios.

[TIP] En Plesk, si no ves la opción de permisos, asegúrate de estar en la vista avanzada. Puedes cambiar entre "Modo simple" y "Modo avanzado" en la esquina superior derecha.

Paso 3: Uso del comando chmod desde el terminal de Plesk

Si tu plan incluye acceso SSH, puedes usar el terminal integrado de Plesk:

Ve a Sitios web y dominios > tu dominio > Acceso SSH.
Ejecuta estos comandos:

find /var/www/vhosts/tudominio.com/httpdocs -type d -exec chmod 755 {} \;
find /var/www/vhosts/tudominio.com/httpdocs -type f -exec chmod 644 {} \;

Reemplaza la ruta con la correcta para tu instalación. Esto aplicará los permisos estándar a todas las carpetas y archivos.

Paso 4: Revisa los permisos desde la interfaz de PrestaShop

Al igual que con cPanel, puedes usar el panel de administración de PrestaShop para verificar y reparar automáticamente. Ve a Parámetros avanzados > Información y busca la sección de permisos.

Solución de permisos en DirectAdmin

DirectAdmin es otro panel muy usado, especialmente en servidores dedicados o VPS. El proceso es parecido:

Paso 1: Abre el Administrador de archivos

Entra en tu DirectAdmin (normalmente en tudominio.com:2222).
Haz clic en Administrador de archivos en el menú principal.
Te pedirá que elijas una ubicación. Selecciona el directorio domains > tudominio.com > public_html.

Paso 2: Cambia los permisos de forma masiva

Marca la casilla Seleccionar todo en la parte superior.
Haz clic en el botón Cambiar permisos (icono de candado).
Introduce los valores numéricos directamente:
- Para carpetas: 755.
- Para archivos: 644.
Aplica los cambios.

[INFO] DirectAdmin te permite escribir el valor numérico directamente, lo cual es más rápido que marcar casillas. Si no estás seguro, usa 755 para todo y luego ajusta los archivos individuales a 644.

Paso 3: Corrige archivos específicos

Si el problema persiste, es probable que haya archivos concretos con permisos incorrectos. Los más comunes en PrestaShop son:

config/settings.inc.php (versiones antiguas).
app/config/parameters.php.
La carpeta var/cache (a veces necesita 777 temporalmente).

Para cambiarlos:

Localiza el archivo.
Haz clic derecho sobre él y elige Cambiar permisos.
Pon 644 para archivos o 755 para carpetas.

Paso 4: Usa el comando chmod desde SSH

Si tienes acceso SSH, este es el método más rápido y fiable:

cd /home/usuario/domains/tudominio.com/public_html
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

Luego, para la carpeta de caché:

chmod -R 777 var/cache

Y después de vaciarla, vuelve a ponerla en 755:

chmod -R 755 var/cache

Errores comunes de permisos en PrestaShop y cómo identificarlos

No todos los errores de permisos se manifiestan igual. Aquí tienes una lista de los más típicos y su causa:

Pantalla blanca al acceder a la tienda: suele deberse a permisos incorrectos en config/ o app/config/.
Error al subir imágenes de productos: la carpeta img no tiene permisos de escritura.
No se puede instalar o actualizar módulos: la carpeta modules o var/cache no permite escritura.
Error de conexión a la base de datos: aunque no es directamente un problema de permisos de archivos, a veces el archivo parameters.php no se puede leer.
Mensaje "Cannot write to file": indica que algún archivo de log o caché no tiene permisos de escritura.

[TIP] Si ves un error de permisos en PrestaShop, lo primero que debes hacer es vaciar la carpeta var/cache (o cache en versiones antiguas). Muchas veces el problema se resuelve solo con eso.

Buenas prácticas y prevención de futuros problemas

Una vez que hayas solucionado los permisos, es importante que adoptes ciertos hábitos para evitar que vuelva a pasar:

No uses permisos 777 de forma permanente. Solo úsalos temporalmente y luego vuelve a 755 o 644.
Haz copias de seguridad periódicas. Si algo falla, puedes restaurar sin perder todo.
Mantén PrestaShop actualizado. Las versiones nuevas suelen corregir problemas de permisos internos.
Usa un usuario FTP con menos privilegios para el día a día. No todo necesita acceso de escritura.
Si usas un hosting compartido, contacta con tu proveedor si los permisos fallan de forma recurrente. Puede ser un problema de configuración del servidor.

Preguntas frecuentes (FAQ)

¿Qué permisos debe tener la carpeta `var/cache` en PrestaShop?

Normalmente 755, pero si tienes problemas de escritura, puedes ponerla a 777 temporalmente, vaciarla y luego volver a 755.

¿Cómo sé si mis permisos están mal?

Entra en el panel de administración de PrestaShop, ve a Parámetros avanzados > Información y busca la sección de permisos. Todo lo que esté en rojo necesita atención.

¿Puedo usar el comando `chmod` desde FTP?

Sí, la mayoría de clientes FTP (como FileZilla) te permiten cambiar permisos haciendo clic derecho sobre el archivo o carpeta. Es un proceso más lento si tienes muchos archivos, pero funciona.

¿Qué hago si después de cambiar permisos mi tienda sigue rota?

Prueba a vaciar la caché manualmente borrando el contenido de var/cache. Si el problema persiste, revisa los logs de error en var/logs para obtener más pistas.

¿Los permisos de archivos afectan al SEO?

Indirectamente, sí. Si tu tienda carga lento o muestra errores, Google puede penalizarte en los resultados de búsqueda. Un sitio con errores de permisos no es fiable para los usuarios ni para los buscadores.

Conclusión

Los errores de permisos en PrestaShop son uno de los problemas más comunes, pero también de los más fáciles de resolver si sigues los pasos adecuados. Tanto en cPanel, Plesk como DirectAdmin, la solución se reduce a cambiar los permisos a 755 para carpetas y 644 para archivos, y usar 777 solo de forma puntual.

Recuerda que la herramienta de diagnóstico de PrestaShop es tu mejor aliada. Úsala siempre que tengas dudas y no te olvides de vaciar la caché después de hacer cambios.

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar al de DirectAdmin, y recuerda que el acceso se realiza a través del puerto 2106 (por ejemplo, tudominio.com:2106). En este panel, también puedes cambiar los permisos desde el administrador de archivos o mediante SSH.

Espero que esta guía te haya sido de ayuda. Si tu tienda sigue dando problemas, no dudes en contactar con tu proveedor de hosting o con un técnico especializado. ¡Tu tienda online merece funcionar perfectamente!