Error de permisos en PrestaShop: cómo solucionarlo (755/644)

¿Tu tienda PrestaShop te muestra errores extraños al subir imágenes, instalar módulos o incluso al intentar acceder al panel de administración? Si ves mensajes como "No se puede escribir en el archivo" o "Error de permisos", no te preocupes. Este es uno de los problemas más comunes en tiendas online basadas en Linux.

En este artículo, te voy a explicar de forma clara y sencilla qué son los PrestaShop permisos, por qué se rompen y, sobre todo, cómo solucionar el molesto error permisos PrestaShop paso a paso, usando comandos básicos como chmod PrestaShop y estableciendo las configuraciones correctas para carpetas 755 PrestaShop y archivos 644 PrestaShop.

Vamos a ello. No necesitas ser un experto en servidores para arreglarlo, solo sigue estas instrucciones al pie de la letra.

¿Qué son los permisos de archivos y carpetas en PrestaShop?

Para entender el problema, primero tienes que imaginarte tu servidor como un edificio de oficinas. Cada archivo y carpeta de tu instalación de PrestaShop tiene una puerta con una cerradura que indica quién puede entrar (leer), quién puede modificar los muebles (escribir) y quién puede ejecutar acciones (ejecutar).

En Linux, estos niveles de acceso se representan con números. Es el famoso sistema de permisos.

4 (r): Permiso de lectura. Puedes ver el contenido.
2 (w): Permiso de escritura. Puedes modificar o borrar el contenido.
1 (x): Permiso de ejecución. Puedes ejecutar scripts o entrar a carpetas.

Cuando hablamos de carpetas 755 PrestaShop, significa que el propietario tiene todos los permisos (7 = 4+2+1), y los grupos y otros usuarios solo tienen lectura y ejecución (5 = 4+1). Esto es lo ideal para las carpetas.

Cuando hablamos de archivos 644 PrestaShop, significa que el propietario puede leer y escribir (6 = 4+2), y el resto solo puede leer (4). Esto es lo correcto para los archivos.

El error aparece cuando estos números se cambian accidentalmente (por ejemplo, al subir archivos por FTP con un programa mal configurado) o cuando un módulo de seguridad los modifica.

¿Por qué aparece el error de permisos en PrestaShop?

El error permisos PrestaShop suele aparecer por estas razones:

Subida de archivos incorrecta: Usar un cliente FTP (como FileZilla) con permisos por defecto que no coinciden con los de tu servidor.
Instalación de módulos o temas: Algunos paquetes vienen con permisos extraños que sobrescriben los tuyos.
Copias de seguridad restauradas: Si restauras una copia hecha en otro servidor, los permisos se copian mal.
Problemas con el usuario del servidor: A veces, el usuario de FTP no es el mismo que el del servidor web (Apache/Nginx), lo que causa conflictos.

Solución paso a paso para arreglar los permisos

Vamos a la acción. Te voy a dar dos métodos: uno fácil usando el panel de control (Syspanel) y otro más técnico usando SSH (si tu hosting lo permite).

Método 1: Usando Syspanel (HestiaCP) para corregir permisos

Si tu hosting utiliza el panel Syspanel (antes conocido como HestiaCP), tienes una ventaja enorme: puedes arreglar los permisos con un clic sin necesidad de saber comandos.

[INFO] Recuerda que para acceder a Syspanel, la URL es https://tu-dominio.com:2106. El puerto 2106 es el que debes usar sí o sí para entrar al panel de administración de tu hosting.

Pasos a seguir:

Accede a tu Syspanel usando el puerto 2106.
Busca la sección de "Web" o "Dominios" y localiza tu tienda PrestaShop.
Dentro de las opciones del dominio, busca un botón que diga "Arreglar permisos" o "Reparar permisos" (la traducción puede variar).
Haz clic en ese botón. El panel ejecutará automáticamente los comandos necesarios para dejar las carpetas 755 PrestaShop y los archivos 644 PrestaShop.
Espera unos segundos y recarga tu tienda. El error debería desaparecer.

Este es el método más rápido y seguro para usuarios sin experiencia técnica. Si tu hosting usa otro panel (cPanel, Plesk), busca una opción similar llamada "File Permissions" o "Repair Permissions".

Método 2: Usando comandos SSH (chmod PrestaShop)

Si eres más atrevido o no tienes la opción en tu panel, puedes usar SSH. Necesitarás un cliente como PuTTY (en Windows) o la terminal (en Mac/Linux).

[WARNING] Ten mucho cuidado con este método. Un error al escribir el comando puede dejar tu tienda inservible. Te recomiendo hacer una copia de seguridad antes de empezar.

Paso 1: Conectarte por SSH

Conéctate a tu servidor con el usuario root o con el usuario que tenga acceso a la carpeta de tu web. Normalmente, la ruta es algo como /home/usuario/web/tudominio/public_html.

Paso 2: Navegar a la carpeta raíz de PrestaShop

Escribe este comando para entrar en la carpeta correcta (ajústalo a tu ruta real):

cd /home/usuario/web/tudominio/public_html

Paso 3: Corregir todos los directorios (carpetas)

Necesitas que todas las carpetas tengan permisos 755. Usa este comando:

find . -type d -exec chmod 755 {} \;

Este comando busca todos los directorios (d) y les aplica el permiso 755.

Paso 4: Corregir todos los archivos

Ahora, para que todos los archivos tengan permisos 644, usa este comando:

find . -type f -exec chmod 644 {} \;

Paso 5: Permisos especiales para la carpeta de caché y archivos de configuración

PrestaShop necesita permisos especiales para ciertas carpetas donde escribe datos constantemente. Después de los pasos anteriores, ejecuta estos comandos para darle permisos de escritura a las carpetas clave:

chmod -R 755 cache
chmod -R 755 log
chmod -R 755 img
chmod -R 755 mails
chmod -R 755 modules
chmod -R 755 themes
chmod -R 755 var
chmod -R 755 config
chmod -R 755 download
chmod -R 755 override
chmod -R 755 translation
chmod -R 755 upload

[TIP] Si no ves la carpeta var, puede que tu versión de PrestaShop sea más antigua y use las carpetas tools/smarty y cache. Ejecuta también chmod -R 755 tools para asegurarte.

Paso 6: El archivo de configuración especial

El archivo settings.inc.php (en PrestaShop 1.6) o parameters.php (en PrestaShop 1.7+) necesita ser escribible a veces para instalar módulos, pero es un riesgo de seguridad tenerlo siempre escribible. Lo más seguro es dejarlo en 444 (solo lectura) después de la instalación. Si te pide permisos de escritura para instalar un módulo, cámbialo temporalmente a 644 y luego vuelve a 444.

chmod 644 config/settings.inc.php
# o para 1.7+
chmod 644 app/config/parameters.php

Paso 7: Propietario (Opcional pero recomendado)

A veces, los permisos numéricos están bien, pero el propietario (owner) es incorrecto. Esto pasa mucho al migrar de servidor. Si tu panel usa el usuario adminweb y el grupo adminweb, ejecuta:

chown -R adminweb:adminweb .

[WARNING] Este último comando es muy importante. Si el propietario es root y el servidor web usa otro usuario, te seguirá dando error de escritura aunque tengas el 755. Pregunta a tu proveedor de hosting cuál es el usuario correcto del FTP.

¿Qué hacer si el error persiste?

Después de hacer todo esto, si el error permisos PrestaShop sigue apareciendo, el problema no son los permisos numéricos. Puede ser:

El módulo de caché: Ve a Parámetros Avanzados > Rendimiento y vacía la caché. A veces, los archivos cacheados se quedan con permisos antiguos.
SELinux (en servidores CentOS/RedHat): Este sistema de seguridad de Linux puede bloquear la escritura aunque los permisos sean correctos. Si tu hosting es gestionado, pide a soporte que desactiven SELinux para tu dominio o que le den el contexto correcto a la carpeta.
Límite de espacio en disco: Suena tonto, pero si tu disco está lleno, no se puede escribir nada. Revisa el espacio libre en tu cuenta de hosting.

Preguntas Frecuentes (FAQ)

¿Es seguro usar permisos 777?
No. Nunca uses 777. Eso significa que cualquiera en el servidor puede leer, escribir y ejecutar. Es una puerta abierta a los hackers. Para PrestaShop permisos, los valores correctos son siempre 755 para carpetas y 644 para archivos.

¿Por qué mi cliente FTP sube archivos con permisos 600?
Porque el programa FTP está configurado para no preservar los permisos originales. En FileZilla, ve a Editar > Ajustes > Transferencias y asegúrate de que "Limitar número de conexiones simultáneas" está activo, pero sobre todo, en el menú "Derechos de acceso" (o Permisos), selecciona la opción "Preservar los atributos de los archivos". Si no, cambia los permisos manualmente después de subir.

¿Tengo que hacer esto cada vez que instalo un módulo?
No, normalmente no. Si instalas módulos desde el marketplace oficial de PrestaShop, los permisos se ajustan solos. El problema suele venir con módulos de terceros descargados de sitios piratas o subidos manualmente por FTP.

¿Qué significa el error "No se puede escribir en el archivo de caché"?
Significa que la carpeta var/cache (o cache en versiones antiguas) no tiene permisos de escritura. Asegúrate de haber ejecutado el comando chmod -R 755 cache o chmod -R 755 var correctamente.

¿Sirve esto para otras plataformas como WooCommerce o Magento?
Los principios son los mismos (755 y 644), pero los comandos específicos de las carpetas varían. Este artículo está enfocado exclusivamente en PrestaShop permisos, pero si entiendes la lógica, podrás aplicarla a otras plataformas.

Resumen final

Arreglar los PrestaShop permisos es una tarea de mantenimiento básica que tarde o temprano tendrás que hacer.

Usa Syspanel si está disponible; es la forma más segura y rápida.
Si usas chmod PrestaShop por SSH, recuerda siempre: carpetas 755 PrestaShop y archivos 644 PrestaShop.
No olvides los permisos especiales de las carpetas de caché y configuración.
Si todo falla, revisa el propietario de los archivos y el espacio en disco.

Con estos pasos, tu tienda volverá a funcionar a la perfección. Si tienes dudas, déjalas en los comentarios y te ayudaré a resolverlas. ¡Suerte con tu tienda!