Errores de permisos en PrestaShop: Solución con Plesk

¿Por qué aparecen errores de permisos en PrestaShop con Plesk?

Si estás leyendo esto, es muy probable que hayas visto un mensaje como "No se puede escribir en el archivo", "Error 403 Prohibido" o "No se puede crear el archivo .htaccess" al administrar tu tienda PrestaShop. No te preocupes, no eres el único. Los errores permisos PrestaShop son una de las consultas más frecuentes en soporte técnico, especialmente cuando el sitio se migra de un servidor a otro o se actualiza la versión de PHP.

El origen de estos problemas casi siempre es el mismo: los archivos y carpetas de tu tienda tienen asignados unos permisos (también llamados chmod) que no coinciden con los que el servidor web necesita para leer, escribir o ejecutar. Plesk, como panel de control, aplica una configuración por defecto que a veces entra en conflicto con los requisitos de PrestaShop. Pero tranquilo, aquí te voy a explicar paso a paso cómo solucionarlo, sin necesidad de ser un experto en Linux ni en línea de comandos.

¿Qué significan realmente los permisos de archivos?

Antes de lanzarnos a cambiar valores, es importante que entiendas qué es eso del chmod PrestaShop. Cada archivo y carpeta en tu servidor tiene tres tipos de permisos: lectura (r), escritura (w) y ejecución (x). Y estos permisos se asignan a tres niveles de usuario: el propietario (dueño), el grupo y el resto de usuarios del sistema.

Cuando ves un número como 755 o 644, es la representación numérica de esos permisos. Por ejemplo:

755: El propietario puede leer, escribir y ejecutar. El grupo y los demás solo leer y ejecutar.
644: El propietario puede leer y escribir. El grupo y los demás solo leer.
775: El propietario y el grupo pueden leer, escribir y ejecutar. Los demás solo leer y ejecutar.

PrestaShop necesita permisos de escritura en carpetas concretas para poder generar cachés, subir imágenes, instalar módulos o actualizar el núcleo. Si esos permisos están restringidos, verás errores de permisos PrestaShop.

Primer paso: Identifica el tipo de error que tienes

No todos los errores de permisos son iguales. Para solucionarlos rápido, debes saber qué está fallando exactamente. Te dejo los tres escenarios más comunes:

1. Error al instalar o actualizar un módulo

Si al intentar instalar un módulo te aparece "No se puede escribir en el directorio /modules", el problema es que la carpeta de módulos no tiene permisos de escritura para el usuario del servidor web.

2. Error al subir imágenes o productos

Si al subir una imagen de producto ves "No se puede copiar la imagen" o "Permiso denegado", la carpeta /img o /upload está bloqueada.

3. Error en el archivo .htaccess o en la caché

Si ves un error de configuración de URL amigables o de caché, el problema suele estar en la carpeta /var/cache o en el propio archivo .htaccess que PrestaShop intenta regenerar.

En cualquiera de los casos, la solución pasa por ajustar los permisos PrestaShop Plesk de forma correcta. Vamos a ello.

Cómo cambiar los permisos desde Plesk (sin usar comandos)

Plesk tiene un administrador de archivos integrado que te permite cambiar los permisos de forma gráfica. Es el método más sencillo para usuarios sin experiencia técnica.

Accede a tu panel de Plesk.
Ve a Sitios web y dominios.
Busca tu dominio y haz clic en Administrador de archivos.
Navega hasta la raíz de tu instalación de PrestaShop (normalmente httpdocs o public_html).
Selecciona todos los archivos y carpetas (puedes usar Ctrl+A).
Haz clic en el botón Permisos (suele estar en la barra superior).
Se abrirá una ventana con casillas. Marca las opciones de Lectura y Escritura para el Propietario.
En el Grupo, marca Lectura y Escritura (y Ejecución si es una carpeta).
Para Otros, deja solo Lectura.
Pulsa Aceptar y espera a que se apliquen los cambios.

Este método es rápido, pero a veces no es suficiente porque PrestaShop necesita permisos específicos en carpetas concretas. Por eso, te recomiendo seguir el siguiente método más preciso.

La configuración recomendada: chmod PrestaShop paso a paso

PrestaShop oficialmente recomienda los siguientes permisos para un funcionamiento óptimo:

Carpetas: 755 (propietario con todos los permisos, grupo y otros con lectura y ejecución).
Archivos: 644 (propietario con lectura y escritura, grupo y otros solo lectura).
Carpetas especiales con escritura: 775 o incluso 777 en entornos de desarrollo.

Las carpetas que necesitan permisos de escritura sí o sí son:

/config
/cache
/log
/img
/mails
/modules
/themes
/translations
/upload
/download
/var
/app (en versiones modernas)

Para aplicar esto, puedes usar el administrador de archivos de Plesk, pero te resultará mucho más rápido si utilizas un cliente FTP como FileZilla. Conéctate a tu servidor y sigue estos pasos:

Selecciona la carpeta raíz de PrestaShop.
Marca la casilla para seleccionar todos los archivos y carpetas.
Haz clic derecho y elige Atributos de archivo.
En la ventana emergente, escribe el valor 644 para archivos y 755 para carpetas.
Aplica los cambios de forma recursiva (selecciona la opción que dice "Recurse into subdirectories").

Este proceso puede tardar unos minutos si tu tienda tiene muchos archivos, pero es la forma más fiable de corregir los errores permisos PrestaShop.

Solución específica para carpetas con problemas

Si después de aplicar la configuración general sigues teniendo errores, es hora de ir a lo fino. Vamos a dar permisos especiales a las carpetas críticas. Desde FileZilla o el administrador de Plesk, localiza cada una de estas carpetas y cambia sus permisos a 775:

/var/cache
/var/logs
/img/tmp
/config/xml
/modules (solo si instalas módulos con frecuencia)

Para ello, haz clic derecho sobre la carpeta, selecciona Atributos de archivo y escribe 775. Marca la opción de aplicar a todas las subcarpetas y archivos internos.

[TIP]: Si tu tienda es de pruebas o la tienes en un entorno local, puedes usar 777 para estas carpetas, pero en producción te recomiendo no pasar de 775 por seguridad.

El problema del propietario de los archivos: el usuario de Plesk

A veces cambias todos los permisos y el error persiste. ¿Por qué? Porque el problema no es el chmod, sino el propietario de los archivos. En Plesk, cada dominio tiene un usuario del sistema (por ejemplo, miweb). El servidor web (Apache o Nginx) ejecuta los scripts con otro usuario (normalmente psacln o www-data). Si los archivos pertenecen al usuario incorrecto, PrestaShop no podrá escribirlos aunque tengan permisos 777.

Para verificar esto en Plesk:

Ve a Sitios web y dominios.
Selecciona tu dominio.
Entra en Configuración de Apache y nginx.
Busca la opción Ejecutar PHP como.
Asegúrate de que está seleccionado FPM application served by Apache o php-fpm, y que el usuario es el mismo que el del dominio.

Si no sabes cuál es, la opción más segura es elegir Modulo PHP o FastCGI y guardar los cambios. Esto hará que PHP se ejecute con el usuario del dominio, evitando conflictos de permisos PrestaShop Plesk.

[WARNING]: Si cambias esta configuración, tu tienda puede tardar unos segundos en recargar. No la hagas en horas punta de ventas.

Cómo reparar los permisos automáticamente con un script

Si no quieres hacerlo a mano, existe una alternativa muy práctica. Puedes crear un pequeño script PHP que se encargue de ajustar todos los permisos automáticamente. Esto es especialmente útil si tienes muchos archivos.

Crea un archivo llamado fix_permissions.php en la raíz de tu PrestaShop.
Pega el siguiente código:

<?php
$dir = __DIR__;
$it = new RecursiveIteratorIterator(
    new RecursiveDirectoryIterator($dir, RecursiveDirectoryIterator::SKIP_DOTS),
    RecursiveIteratorIterator::SELF_FIRST
);
foreach ($it as $item) {
    if ($item->isDir()) {
        chmod($item->getPathname(), 0755);
    } else {
        chmod($item->getPathname(), 0644);
    }
}
echo "Permisos ajustados correctamente.";

Guárdalo y ejecútalo desde tu navegador: https://tudominio.com/fix_permissions.php.
Borra el archivo inmediatamente después de ejecutarlo para evitar riesgos de seguridad.

Este script aplicará chmod PrestaShop de forma correcta en toda la instalación. Luego ya puedes ajustar las carpetas especiales a 775 manualmente.

[INFO]: Si tu hosting usa Syspanel (antes conocido como HestiaCP), el procedimiento es similar. Solo recuerda que el acceso a tu panel de administración es a través del puerto 2106, y desde el administrador de archivos de Syspanel también puedes cambiar los permisos gráficamente.

Errores de permisos al instalar PrestaShop desde Plesk

Si estás instalando PrestaShop por primera vez y ya te salen errores de permisos, es posible que el instalador no pueda crear el archivo settings.inc.php en la carpeta /config. Esto es muy común cuando el paquete de instalación se ha subido con permisos incorrectos.

La solución rápida es:

Crea la carpeta /config manualmente si no existe.
Dentro de ella, crea un archivo vacío llamado settings.inc.php.
Dale permisos 644 a ese archivo.
Vuelve a intentar la instalación.

Durante la instalación, PrestaShop te pedirá permisos de escritura en varias carpetas. Si alguna aparece en rojo, anota cuál es y aplícale el permiso 775 desde el administrador de archivos de Plesk.

Preguntas frecuentes sobre errores de permisos en PrestaShop con Plesk

¿Es seguro usar permisos 777 en PrestaShop?

No es recomendable en producción. Los permisos 777 permiten que cualquier usuario del sistema pueda escribir en esos archivos, lo que supone un riesgo de seguridad importante. Úsalos solo de forma puntual y revierte a 775 o 755 en cuanto soluciones el error.

¿Por qué después de cambiar los permisos el error sigue apareciendo?

Puede deberse a tres razones: no has cambiado el propietario de los archivos, el módulo de PHP no está configurado correctamente, o tu servidor tiene un sistema de caché (como Varnish) que está mostrando una versión antigua del sitio. Prueba a vaciar la caché de PrestaShop y la del navegador.

¿Cada cuánto tiempo debo revisar los permisos de mi tienda?

Te recomiendo revisarlos cada vez que hagas una actualización de PrestaShop, instales un módulo o migres de servidor. También es buena práctica hacerlo tras un ataque o un intento de intrusión.

¿Puedo evitar estos errores de permisos en el futuro?

Sí, manteniendo siempre actualizada tu versión de PrestaShop y usando un hosting que tenga Plesk con PHP-FPM configurado correctamente. Además, evita subir archivos modificados de una instalación local a tu servidor sin ajustar antes los permisos.

Resumen final: recupera el control de tu tienda

Los errores permisos PrestaShop con Plesk son molestos, pero tienen solución. Recuerda la regla de oro: carpetas a 755, archivos a 644, y carpetas de escritura a 775. Si aun así el problema persiste, revisa el propietario de los archivos y la configuración de PHP en Plesk. Con estos pasos tendrás tu tienda funcionando en menos de lo que tardas en preparar un café.

Y si en algún momento te sientes perdido, no dudes en contactar con tu proveedor de hosting. Ellos pueden acceder al servidor y ajustar los permisos por ti, especialmente si no te sientes cómodo tocando la configuración. Pero con esta guía, estoy seguro de que podrás resolverlo tú mismo la mayoría de las veces.

Ahora ya sabes cómo atacar el problema de raíz. Ponte manos a la obra y recupera el control de tu PrestaShop. ¡Tu tienda te lo agradecerá!