Permisos de archivos en PrestaShop: Cómo configurarlos correctamente

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás viendo errores como "No se puede escribir en el archivo", *"permiso denegado"**, o problemas al subir imágenes, módulos o al generar la caché, el problema casi siempre está relacionado con los permisos de archivos de tu instalación.

Los permisos de archivos (también conocidos como chmod) son un sistema de seguridad de Linux (y otros sistemas) que controla quién puede leer, escribir o ejecutar un archivo o carpeta. En PrestaShop, estos permisos son críticos porque la tienda necesita escribir constantemente en ciertos directorios para funcionar correctamente: caché, logs, archivos temporales, imágenes subidas, etc.

Cuando estos permisos están mal configurados, tu tienda puede volverse lenta, mostrar errores extraños o incluso quedarse bloqueada en blanco. No te preocupes, en esta guía te explicaré paso a paso cómo diagnosticar y resolver los problemas de permisos de forma sencilla, incluso si no eres un experto técnico.

Entendiendo los permisos: qué es el chmod y cómo funciona

Antes de lanzarnos a cambiar cosas, es importante que entiendas lo básico. Los permisos se representan con un número de tres dígitos (por ejemplo, 755 o 644). Cada dígito representa los permisos para un tipo de usuario:

Primer dígito: El propietario (tú, el dueño del archivo).
Segundo dígito: El grupo (usuarios del servidor en el mismo grupo).
Tercer dígito: El resto de usuarios (público en general).

Cada dígito es la suma de tres valores:

4: Permiso de lectura (ver el archivo).
2: Permiso de escritura (modificar el archivo).
1: Permiso de ejecución (ejecutar scripts).

Por ejemplo, el permiso 755 significa:

Propietario: 4+2+1 = 7 (lectura, escritura y ejecución).
Grupo: 4+1 = 5 (lectura y ejecución).
Público: 4+1 = 5 (lectura y ejecución).

En PrestaShop, la regla general es:

Carpetas: 755 (a veces 775 si usas un servidor con PHP como módulo de Apache).
Archivos: 644 (a veces 664).
Archivos de configuración especiales (como config/settings.inc.php): 444 o 440 en producción para que nadie pueda modificarlos, pero en desarrollo suelen ser 644.

Cómo acceder a tu servidor para cambiar permisos

Para cambiar los permisos archivos prestashop, necesitas acceder al panel de control de tu hosting o a un cliente FTP (como FileZilla). Hay dos caminos principales:

1. A través del administrador de archivos del hosting

La mayoría de los paneles de control (cPanel, Plesk, o Syspanel) tienen un administrador de archivos integrado.

Inicia sesión en tu panel de control. Si tu hosting usa Syspanel, recuerda que el acceso es a través del puerto 2106 (por ejemplo, https://tu-dominio.com:2106).
Busca la sección "Administrador de archivos" o "Archivos".
Navega hasta la raíz de tu PrestaShop (normalmente public_html o www).
Selecciona un archivo o carpeta, haz clic derecho y elige "Cambiar permisos" o "Chmod".
Introduce el valor numérico (por ejemplo, 755) y guarda.

2. A través de un cliente FTP (FileZilla)

Conecta FileZilla a tu servidor con tus credenciales FTP.
Selecciona todos los archivos y carpetas de tu PrestaShop.
Haz clic derecho y selecciona "Permisos de archivo".
Introduce el valor numérico y marca la opción "Aplicar a todos los archivos y carpetas" (o "Recurse into subdirectories").
Acepta y espera a que el proceso termine.

Pasos para corregir los errores de permisos en PrestaShop

Si ya estás viendo errores de permisos, sigue estos pasos en orden. Son los más efectivos para resolver el 90% de los casos.

Paso 1: Restablecer los permisos estándar

La forma más rápida de solucionar la mayoría de los problemas es restablecer los permisos a los valores estándar que PrestaShop espera.

Para todas las carpetas: Deben tener 755.
Para todos los archivos: Deben tener 644.

¿Cómo hacerlo sin morir en el intento?

Con FileZilla es muy fácil:

Conecta y selecciona la carpeta raíz de PrestaShop.
Haz clic derecho → "Permisos de archivo".
En el campo numérico, escribe 755.
Marca "Recurse into subdirectories" y luego elige "Apply to directories only" (Aplicar solo a directorios). Acepta.
Repite el proceso, pero ahora escribe 644 y elige "Apply to files only" (Aplicar solo a archivos).

[TIP] Este proceso puede tardar unos minutos si tu tienda tiene muchos archivos. No lo interrumpas.

Paso 2: Dar permisos especiales a carpetas de escritura

PrestaShop necesita que ciertas carpetas sean escribibles por el servidor para poder generar caché, subir imágenes o instalar módulos. Después del paso 1, es posible que necesites dar permisos un poco más abiertos a estas carpetas específicas:

/cache
/log
/img
/download
/upload
/config
/translations
/themes

Para estas carpetas, el permiso recomendado suele ser 755 o, en algunos servidores, 775. Si sigues teniendo problemas, prueba con 777 de forma temporal (no recomendado para producción, pero útil para diagnosticar).

[WARNING] Usar permisos 777 significa que cualquiera puede escribir en esa carpeta. Es un riesgo de seguridad. Úsalo solo para probar y vuelve a cambiarlo a 755 en cuanto soluciones el problema.

Paso 3: Corregir el propietario de los archivos (Owner)

A veces el problema no es el número de permisos, sino quién es el propietario de los archivos. En muchos servidores, los archivos deben pertenecer al usuario de FTP (por ejemplo, usuario:usuario), no al usuario del servidor web (por ejemplo, www-data o nobody).

Si los permisos son correctos pero sigues recibiendo errores, verifica el propietario:

En FileZilla, ve a Servidor → Mostrar archivos ocultos (no siempre necesario).
Haz clic derecho en un archivo o carpeta y selecciona "Permisos de archivo".
En la parte inferior, verás los campos de "Usuario" y "Grupo".
Deben coincidir con tu usuario y grupo de FTP.

Si no coinciden, no hay una forma fácil de cambiarlo desde FileZilla. Tendrás que usar el administrador de archivos de tu panel de control (Syspanel, cPanel, etc.) o contactar con tu proveedor de hosting para que lo cambien.

Paso 4: Desactivar la caché de PrestaShop

A veces los errores de permisos son un falso amigo. La caché de PrestaShop puede guardar datos corruptos que generan errores similares. Para descartar esto:

Ve a tu Back Office de PrestaShop.
Navega a Parámetros avanzados → Rendimiento.
En "Caché", selecciona "No".
Guarda los cambios.
También puedes borrar la carpeta /cache/smarty/compile y /cache/smarty/cache manualmente, pero no borres los archivos .htaccess que estén dentro.

[INFO] Si no puedes acceder al Back Office porque la tienda está rota, borra manualmente el contenido de las carpetas /cache/smarty/compile y /cache/smarty/cache desde FTP. Esto suele reactivar la tienda.

Errores comunes y sus soluciones específicas

Aquí tienes una lista de los errores de permisos más frecuentes en PrestaShop y cómo atajarlos.

Error: "No se puede escribir en el archivo de configuración"

Este error suele aparecer al instalar o actualizar un módulo.

Solución: Asegúrate de que el archivo config/settings.inc.php tenga permisos 644 o 444 (solo lectura). Si es 777, es un riesgo de seguridad enorme. Cambia el propietario a tu usuario si es necesario.

Error: "No se puede crear el archivo de imagen"

Aparece al subir imágenes de productos o logos.

Solución: Verifica que las carpetas /img y /upload tengan permisos 755 o 775. Además, asegúrate de que el propietario sea el correcto.

Error: "No se puede escribir en el directorio de módulos"

Al intentar instalar un módulo desde el Back Office.

Solución: La carpeta /modules necesita permisos 755 y el propietario correcto. Si usas un servidor con PHP como módulo (mod_php), a veces necesitas 775 o incluso 777 temporalmente para que el servidor web pueda crear archivos.

Error: "La página se queda en blanco" (WSOD - White Screen of Death)

Puede ser por muchas cosas, pero los permisos son un sospechoso habitual.

Solución: Revisa los logs de error en /log. Primero, da permisos 755 a la carpeta /log y 644 a los archivos dentro. Luego, activa el modo de depuración de PrestaShop (en config/defines.inc.php, cambia _PS_MODE_DEV_ a true) para ver el error exacto.

Prevención: cómo evitar futuros problemas de permisos

Una vez que has resuelto el problema, es buena idea tomar medidas para que no vuelva a ocurrir.

Configura bien tu hosting: Si usas un servidor compartido, es normal que los permisos sean más restrictivos. Si usas un VPS o dedicado, asegúrate de que PHP corra como tu usuario (PHP-FPM) en lugar de como www-data. Esto hace que los permisos estándar (755/644) funcionen sin problemas.
Evita los permisos 777: Aunque solucionan temporalmente, son una puerta abierta a ataques. Úsalos solo para diagnosticar y cámbialos después.
Mantén PrestaShop actualizado: Las actualizaciones suelen corregir errores de gestión de archivos.
Usa un buen plan de hosting: Un hosting que soporte bien PrestaShop nativamente (con PHP-FPM y LiteSpeed o Nginx) te dará muchos menos dolores de cabeza.

Preguntas frecuentes (FAQ) sobre permisos en PrestaShop

¿Qué permisos deben tener las carpetas de PrestaShop?
Las carpetas deben tener 755 (o 775 si tu servidor lo pide). Los archivos deben tener 644 (o 664).

¿Puedo usar 777 para todo?
No, es muy peligroso. Cualquier visitante podría modificar o borrar archivos de tu tienda. Úsalo solo de forma temporal para pruebas y cámbialo después.

¿Por qué mi hosting me pide permisos 775?
Porque el servidor web (Apache) está configurado como un grupo diferente al tuyo. Es una configuración común en algunos hostings compartidos. Si 755 no funciona, prueba con 775.

¿Cómo sé si el problema es de permisos o de otra cosa?
Si el error menciona "permiso denegado", "no se puede escribir", "no se puede crear", es casi seguro un problema de permisos. Si es una página en blanco, revisa los logs y el modo dev.

¿Qué hago si nada de esto funciona?
Prueba a restaurar una copia de seguridad de los archivos. A veces, una actualización fallida o una restauración parcial dejan permisos corruptos. Si el problema persiste, contacta con tu proveedor de hosting. Ellos pueden verificar la configuración del servidor y el propietario real de los archivos.

Conclusión

Los problemas de permisos archivos prestashop son frustrantes, pero casi siempre tienen una solución sencilla. La clave está en mantener la calma, seguir los pasos de diagnóstico (restablecer a 755/644, dar permisos especiales a las carpetas de escritura y verificar el propietario) y, sobre todo, en configurar correctamente los permisos prestashop desde el principio.

Recuerda que la seguridad es lo primero: evita los permisos 777 en producción y mantén tu tienda actualizada. Con esta guía, ya tienes las herramientas para resolver los errores de permisos más comunes y para prevenir futuros dolores de cabeza. Si te has quedado atascado, revisa los logs y no dudes en pedir ayuda a tu hosting. ¡Tu tienda volverá a funcionar en poco tiempo!