Permisos de archivos en PrestaShop con Plesk | Solución

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más comunes (y frustrantes) al gestionar una tienda PrestaShop alojada en un servidor con Plesk: los errores de permisos de archivos. No te preocupes, aunque suene técnico, te guiaré paso a paso con un lenguaje claro y ejemplos prácticos.

Si alguna vez has visto mensajes como "Error de escritura", "No se puede crear el archivo de configuración", "Error 500 Internal Server", o "La imagen no se puede subir", es muy probable que el problema sean los permisos de archivos y directorios de tu PrestaShop. Vamos a solucionarlo.

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

Imagina que tu servidor es un edificio de oficinas. Cada archivo y carpeta de tu PrestaShop es una habitación o un documento. Los permisos son las reglas que deciden quién puede entrar, quién puede leer los documentos, quién puede modificarlos y quién puede eliminarlos.

En un entorno de hosting con Plesk, hay tres actores principales:

El Propietario (Owner): Normalmente el usuario del sistema que creó los archivos (tu cuenta de hosting).
El Grupo (Group): Un conjunto de usuarios con permisos similares (por ejemplo, el grupo psacln o www-data en Plesk).
Otros (Others/World): Cualquier otro usuario del sistema.

Cada uno de estos actores puede tener tres tipos de permisos:

Lectura (r): Ver el contenido del archivo o listar la carpeta.
Escritura (w): Modificar o eliminar el archivo, o crear/eliminar archivos dentro de una carpeta.
Ejecución (x): Ejecutar un archivo (si es un script) o acceder a una carpeta (poder entrar en ella).

PrestaShop necesita permisos específicos para funcionar correctamente. Por ejemplo:

La carpeta config necesita permisos de escritura para que PrestaShop pueda guardar la configuración de la tienda.
La carpeta upload o img necesita permisos de escritura para que puedas subir imágenes de productos.
Los archivos de caché (var/cache) necesitan permisos de escritura para que la tienda cargue rápido.

Cuando estos permisos no son correctos, aparecen los errores permisos PrestaShop que tanto molestan.

Identificando el problema: Señales de alerta de permisos incorrectos

Antes de empezar a corregir, es clave saber qué estamos buscando. Estos son los síntomas más comunes de problemas de permisos PrestaShop Plesk:

Error al instalar o actualizar un módulo: Aparece un mensaje como "No se puede copiar el archivo" o "Permiso denegado".
Error al subir imágenes: Las imágenes de productos o del slider no se cargan y ves un error en la consola del navegador.
Error 500 Internal Server Error: La página se queda en blanco o muestra este error genérico.
La tienda se vuelve lenta o no guarda cambios: Al modificar un producto, los cambios no se aplican.
Error al generar el archivo .htaccess: PrestaShop no puede regenerar las reglas de URL amigables.
El instalador de PrestaShop se queda atascado: Durante la instalación inicial, no puede crear archivos de configuración.

Si te suena alguno de estos, sigue leyendo. Vamos a corregir permisos archivos PrestaShop de manera segura.

Solución paso a paso: Cómo corregir los permisos en Plesk

Plesk es un panel de control muy potente y, aunque tiene su propia interfaz, la forma más fiable de cambiar permisos es a través del Administrador de Archivos o mediante SSH (acceso por terminal). Te explicaré ambos métodos. El primero es más visual y seguro para principiantes.

Método 1: Usando el Administrador de Archivos de Plesk (Recomendado)

Este método es ideal si no te sientes cómodo con líneas de comandos.

Accede a Plesk: Abre tu navegador y ve a la URL de tu panel Plesk (normalmente https://tudominio.com:8443 o https://tu-ip:8443). Inicia sesión con tus credenciales de hosting.
Ve a Archivos: En el panel principal, busca la sección "Archivos" o "Administrador de Archivos". Suele estar en el menú de la izquierda o en la pestaña de tu dominio. Haz clic en tu dominio.
Navega a la raíz de PrestaShop: Dentro del Administrador de Archivos, localiza la carpeta donde está instalado PrestaShop. Normalmente es httpdocs, public_html o la raíz del dominio. Ahí verás todas las carpetas de PrestaShop (admin, cache, classes, config, etc.).
Selecciona todo (cuidado con la carpeta admin): Marca la casilla superior para seleccionar todos los archivos y carpetas. IMPORTANTE: No selecciones la carpeta admin si quieres mantenerla más segura. La carpeta admin debe tener permisos más restrictivos (normalmente 755). Si no estás seguro, selecciona todo.
Cambia los permisos: Una vez seleccionados, busca el botón "Permisos" o "Change Permissions" en la barra de herramientas (suele tener un icono de candado o de usuario). Haz clic.
Configura los valores correctos:
- Para la mayoría de archivos y carpetas (excepto config, cache, upload, img, download, themes, modules, translations, mails, override):
  - Propietario: Lectura y Escritura (rw) (marcar las dos casillas).
  - Grupo: Lectura y Ejecución (r-x) (marcar Lectura y Ejecución).
  - Otros: Lectura y Ejecución (r-x) (marcar Lectura y Ejecución).
  - En notación numérica, esto es 755.
- Para las carpetas que necesitan escritura (las mencionadas arriba):
  - Propietario: Lectura y Escritura (rw).
  - Grupo: Lectura, Escritura y Ejecución (rwx). ¡Ojo! Aquí marcamos también Escritura para el grupo.
  - Otros: Lectura y Ejecución (r-x).
  - En notación numérica, esto es 775.
- Para los archivos dentro de esas carpetas especiales (no las carpetas en sí): Se suele usar 664 (propietario rw, grupo rw, otros r). Pero Plesk a veces aplica recursivamente, así que con 775 en las carpetas suele bastar.
Aplica los cambios: Marca la opción "Recursivo" o "Aplicar a todos los archivos y subdirectorios" (si aparece). Esto hará que los permisos se apliquen a todo el contenido dentro de las carpetas seleccionadas. Luego haz clic en "Aceptar" o "Aplicar".
Ajustes finos (opcional pero recomendado): Después del cambio masivo, es buena práctica volver a la carpeta config y asegurarte de que tenga permisos 775 (o 777 como último recurso, pero intenta siempre 775 primero). También la carpeta cache debe ser 775.

[TIP] Si después de esto sigues teniendo errores, prueba con permisos 777 en las carpetas problemáticas (como config, cache o var/cache). PERO SOLO COMO PRUEBA TEMPORAL. Si funciona, entonces es que tu servidor necesita que el grupo de escritura sea "world". En ese caso, contacta con tu proveedor de hosting para que configure el grupo correcto (psacln suele ser el grupo en Plesk).

Método 2: Usando SSH (Para usuarios más avanzados)

Si tienes acceso SSH (Shell) a tu servidor, este método es mucho más rápido y preciso. Necesitarás las credenciales SSH de tu hosting.

Conéctate por SSH: Usa un cliente como PuTTY (Windows) o la terminal (Mac/Linux). El comando típico es: ssh usuario@tudominio.com o ssh usuario@tu-ip.
Navega a la raíz de PrestaShop: Una vez dentro, usa cd para ir a la carpeta de tu tienda. Normalmente: cd /var/www/vhosts/tudominio.com/httpdocs/ o cd ~/httpdocs.
Establece los permisos correctos con comandos:
- Para archivos (la mayoría): Permisos 644 (propietario rw, grupo r, otros r).
```
find . -type f -exec chmod 644 {} \;
```
- Para directorios (la mayoría): Permisos 755 (propietario rwx, grupo rx, otros rx).
```
find . -type d -exec chmod 755 {} \;
```
- Para las carpetas especiales que necesitan escritura (config, cache, upload, img, download, themes, modules, translations, mails, override, var): Permisos 775 (propietario rwx, grupo rwx, otros rx).
```
chmod -R 775 config cache upload img download themes modules translations mails override var
```
- Para los archivos dentro de esas carpetas especiales (opcional, pero a veces necesario): Permisos 664.
```
find config cache upload img download themes modules translations mails override var -type f -exec chmod 664 {} \;
```
Verifica el propietario y grupo: Es crucial que el propietario de los archivos sea el usuario de tu hosting (ej. usuario) y el grupo sea psacln (o www-data en algunos servidores). Si no es así, puedes cambiarlo con:
```
chown -R usuario:psacln .
```
(Reemplaza usuario por tu nombre de usuario de Plesk).

[WARNING] Ten mucho cuidado al usar chmod -R 777 o chown -R en toda la raíz. Un error puede dejar tu tienda insegura o inaccesible. Siempre es mejor ser específico con las carpetas.

Preguntas Frecuentes (FAQ)

P: ¿Por qué después de cambiar los permisos a 755/775 sigo teniendo errores?
R: Puede que el problema no sean solo los permisos, sino el propietario y grupo de los archivos. Asegúrate de que el grupo sea el correcto (normalmente psacln en Plesk). También verifica que el archivo settings.inc.php (en la carpeta config) tenga permisos de escritura (664 o 666) durante la instalación o configuración, y luego cámbialo a 644 por seguridad.

Q: ¿Es seguro usar permisos 777?
R: No, a menos que sea absolutamente necesario y temporal. Los permisos 777 permiten a cualquier usuario del sistema modificar los archivos, lo que es un riesgo de seguridad. Siempre intenta 775 primero. Si tu servidor requiere 777, es mejor contactar con el soporte técnico de tu hosting.

Q: ¿Cada vez que actualizo PrestaShop debo cambiar los permisos?
R: Sí, es muy recomendable. Las actualizaciones pueden cambiar la estructura de carpetas y archivos, y a veces restablecen permisos más restrictivos. Después de cada actualización, ejecuta los comandos o el proceso del Administrador de Archivos para asegurarte de que todo está en orden.

Q: Mi tienda está en un servidor con Syspanel (HestiaCP). ¿El proceso es el mismo?
R: El concepto es el mismo, pero la interfaz cambia. En Syspanel (HestiaCP), el puerto de acceso suele ser el 2106. Dentro del panel, busca "Administrador de Archivos" o "File Manager". Los permisos numéricos (755, 775, 644) son universales, así que los pasos de cambiar a 755 para directorios y 644 para archivos, y luego 775 para las carpetas especiales, aplican igual. La principal diferencia es que el grupo de usuario puede variar (a veces es www-data). Si tienes dudas, consulta la documentación de tu hosting.

Q: He probado todo y sigo con errores. ¿Qué hago?
R: No te desesperes. A veces el problema no son los permisos de archivos, sino la configuración del servidor (como el modo seguro de PHP, o la configuración de SELinux). Contacta con el soporte técnico de tu proveedor de hosting y diles que has revisado los permisos de PrestaShop en Plesk pero el error persiste. Ellos podrán revisar la configuración del servidor.

Resumen rápido de permisos recomendados

Carpeta / Archivo	Permisos (Numérico)	Permisos (Simbólico)
Directorios (raíz y mayoría)	755	rwx r-x r-x
Archivos (raíz y mayoría)	644	rw- r-- r--
`config/`, `cache/`, `upload/`, `img/`, `download/`, `themes/`, `modules/`, `translations/`, `mails/`, `override/`, `var/`	775	rwx rwx r-x
`settings.inc.php` (temporal)	666 o 664	rw- rw- rw-
`settings.inc.php` (producción)	644	rw- r-- r--

¡Y eso es todo! Espero que este artículo te haya ayudado a entender y solucionar los problemas de permisos en tu PrestaShop con Plesk. Recuerda que la paciencia es clave. Si sigues estos pasos, tu tienda volverá a funcionar sin esos molestos errores. ¡Mucho éxito con tu tienda online!