Problemas de permisos en PrestaShop con Syspanel: solución fácil

¡Hola! Soy el técnico de soporte amigable, y hoy vamos a resolver uno de los problemas más comunes (y frustrantes) en PrestaShop: los errores de permisos. Si ves mensajes como "Error 500", "No se puede escribir en la carpeta" o simplemente tu tienda no carga correctamente, es muy probable que el problema esté en los permisos de archivos y carpetas.

No te preocupes, aquí te explico paso a paso cómo solucionarlo, especialmente usando Syspanel (nuestro panel de control basado en HestiaCP, que accedes por el puerto 2106). Vamos a ello.

¿Qué son los permisos y por qué dan error en PrestaShop?

Imagina que tu tienda PrestaShop es una casa. Los archivos y carpetas son las habitaciones, y los permisos son las llaves que indican quién puede entrar, leer, escribir o modificar cada habitación.

PrestaShop necesita escribir en ciertas carpetas para funcionar: para subir imágenes, generar archivos de caché, instalar módulos o actualizar la tienda. Si los permisos no son los correctos, el sistema no puede hacer su trabajo y aparece el temido error permisos PrestaShop.

Los síntomas más habituales son:

Tu tienda se vuelve invisible (pantalla en blanco o error 500).
No puedes subir imágenes de productos.
Los módulos no se instalan o dan error.
Aparece un mensaje como: "Error: no se puede escribir en la carpeta /cache".
La página de administración carga muy lento o no carga.

¿Cuáles son los permisos correctos para PrestaShop?

Para que PrestaShop funcione sin problemas, necesitas establecer una configuración específica. La regla de oro es:

Carpetas (directorios): Permiso 755 (rwxr-xr-x). Esto significa que el propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar.
Archivos: Permiso 644 (rw-r--r--). El propietario puede leer y escribir; el grupo y otros solo pueden leer.

Pero hay una excepción importante: algunas carpetas necesitan permisos más abiertos (normalmente 755 o incluso 777 en casos muy específicos) para que PrestaShop pueda escribir en ellas. Las carpetas clave son:

/cache
/config
/img
/log
/mails
/modules
/themes (y sus subcarpetas)
/translations
/upload
/download
/sitemap.xml (archivo)

[INFO] En la mayoría de los casos, con permisos 755 en carpetas y 644 en archivos es suficiente. El 777 solo debe usarse temporalmente y si sabes lo que haces, ya que puede ser un riesgo de seguridad.

Solucionar permisos PrestaShop paso a paso con Syspanel

Vamos a la práctica. Aquí te explico cómo corregir los permisos usando Syspanel (tu panel de control, que recuerda, se accede por el puerto 2106, por ejemplo: tudominio.com:2106).

Paso 1: Accede a Syspanel

Abre tu navegador y escribe la dirección de tu Syspanel: https://tudominio.com:2106 (o la IP de tu servidor).
Inicia sesión con tu usuario y contraseña de administrador.

Paso 2: Identifica tu plan de alojamiento

Dentro de Syspanel, busca la sección "WEB" o "Sitios Web". Ahí verás una lista de tus dominios. Haz clic en el dominio donde está instalada tu tienda PrestaShop.

Paso 3: Accede al Administrador de Archivos

Dentro de la configuración de tu dominio, busca una opción que se llame "Administrador de Archivos", "File Manager" o similar. Es una herramienta visual que te permite navegar por las carpetas de tu web sin necesidad de usar FTP.

Paso 4: Navega a la raíz de PrestaShop

Una vez dentro del Administrador de Archivos, verás la estructura de carpetas de tu web. Busca la carpeta donde está instalado PrestaShop (normalmente es la raíz, como public_html o www). Dentro, verás las carpetas típicas de PrestaShop: admin, cache, config, img, etc.

Paso 5: Cambia los permisos de forma masiva (la solución más rápida)

Esta es la forma más eficiente de solucionar el error de permisos. Vamos a cambiar los permisos de todas las carpetas y archivos de una sola vez.

En el Administrador de Archivos, selecciona TODOS los archivos y carpetas de la raíz de PrestaShop. Puedes usar el checkbox superior o la combinación de teclas Ctrl+E (en Windows) o Cmd+E (en Mac).
Busca un botón o enlace que diga "Permisos", "Cambiar permisos" o "Chmod". Al hacer clic, se abrirá una ventana.
Verás una opción para aplicar cambios de forma recursiva (a todas las subcarpetas y archivos). Es muy importante que marques esta opción.
Ahora, establece los permisos:
- Para las carpetas: Marca las casillas para que quede 755 (rwx para el propietario, r-x para grupo y otros).
- Para los archivos: Marca las casillas para que quede 644 (rw- para el propietario, r-- para grupo y otros).
Haz clic en "Aceptar" o "Cambiar permisos". El proceso puede tardar unos segundos.

[TIP] Si tu Administrador de Archivos no te permite diferenciar entre archivos y carpetas en un solo paso, puedes hacerlo en dos rondas: primero selecciona todo y pon 755, y luego (si es posible) repite la operación pero solo para archivos, poniendo 644. Otra opción es usar el terminal de Syspanel (si está disponible) con comandos, como explico más abajo.

Paso 6: Verifica el propietario (muy importante)

A veces, el problema no es solo el permiso numérico, sino que el propietario de los archivos no es el correcto. PrestaShop necesita que el usuario del servidor web (normalmente www-data o nobody) sea el propietario o, al menos, esté en el grupo del propietario.

En Syspanel, busca una opción como "Propietario" o "Permisos de usuario". Asegúrate de que:

El usuario propietario sea el mismo que el usuario de tu plan de alojamiento (el que usas para acceder a Syspanel).
El grupo sea también el correcto (a menudo es el mismo nombre de usuario o www-data).

Si no sabes cómo cambiarlo, no te preocupes. En el siguiente apartado te doy una solución con comandos (más avanzada, pero muy efectiva).

Solución avanzada: Usar el terminal de Syspanel (para usuarios con algo de experiencia)

Si el método gráfico no te funciona o prefieres la línea de comandos, Syspanel suele incluir un terminal. Puedes acceder desde la sección "Terminal" o "SSH" (si está habilitada).

Una vez dentro, escribe estos comandos (uno por uno) para solucionar los permisos de raíz:

# 1. Ve a la carpeta de tu tienda (ajusta la ruta si es diferente)
cd /home/tuusuario/web/tudominio/public_html

# 2. Cambia el propietario de todos los archivos al usuario del servidor web
#    (normalmente 'www-data' o 'nobody'). El usuario 'tuusuario' es el de Syspanel.
sudo chown -R tuusuario:www-data .

# 3. Establece permisos 755 para todas las carpetas
find . -type d -exec chmod 755 {} \;

# 4. Establece permisos 644 para todos los archivos
find . -type f -exec chmod 644 {} \;

# 5. (Opcional) Si alguna carpeta sigue dando problemas, dale 755 específicamente
#    Por ejemplo: chmod -R 755 cache config img log mails modules themes translations upload download

[WARNING] El comando chown con sudo puede ser peligroso si te equivocas de ruta. Asegúrate de estar en la carpeta correcta. Si no tienes permisos de superusuario, omite el sudo y usa solo chown.

Preguntas Frecuentes (FAQ) sobre permisos PrestaShop

Aquí tienes las dudas más comunes que resuelvo a diario.

¿Por qué sigo teniendo error de permisos después de cambiarlos?

Esto suele pasar por dos razones:

Propietario incorrecto: Aunque los permisos numéricos sean correctos, si el archivo pertenece a otro usuario (por ejemplo, root), el servidor web no podrá escribirlo. Revisa el paso 6 de la guía.
PHP con modo seguro (safe_mode): Si tu hosting tiene el modo seguro de PHP activado, los permisos tradicionales no funcionan. Debes contactar con el soporte de tu hosting para que lo desactiven o te den una solución alternativa.

¿Es seguro usar permisos 777?

No, en absoluto. El permiso 777 significa que cualquiera (cualquier usuario del servidor) puede leer, escribir y ejecutar ese archivo o carpeta. Es una puerta abierta para ataques de seguridad. Úsalo solo de forma temporal y con carpetas muy específicas (como /cache o /img temporalmente para solucionar un error), y luego vuelve a poner 755.

¿Cómo sé si el error es de permisos o de otra cosa?

El error de permisos suele ir acompañado de mensajes como:

"Cannot write to file"
"Permission denied"
"Unable to create folder"
"Error 500" (a veces, aunque no siempre)
"El archivo no se puede mover a la carpeta de destino"

Si ves estos mensajes en el back office de PrestaShop (por ejemplo, al subir una imagen), es casi seguro un problema de permisos.

¿Cada vez que actualizo PrestaShop tengo que cambiar los permisos?

No siempre, pero es recomendable. Las actualizaciones pueden modificar algunos archivos y, a veces, los permisos se restablecen a valores incorrectos. Después de una actualización importante, siempre es buena práctica verificar los permisos de las carpetas clave (/cache, /config, /img, etc.) y, si es necesario, reaplicar la configuración 755/644.

Mi tienda funciona, pero no puedo instalar módulos. ¿Qué hago?

Este es un clásico. Asegúrate de que la carpeta /modules tenga permisos 755 y que el propietario sea el correcto. También revisa la carpeta /config y el archivo config/settings.inc.php (o app/config/parameters.php en PrestaShop 1.7+). Este archivo debe tener permiso 644 y ser propiedad del usuario del servidor web.

Conclusión: Un mantenimiento sencillo para tu tienda

Los problemas de permisos en PrestaShop son molestos, pero con esta guía y el uso de Syspanel (recuerda, por el puerto 2106), puedes solucionarlos en pocos minutos. La clave está en:

Usar 755 para carpetas y 644 para archivos.
Asegurarte de que el propietario sea el correcto.
Aplicar los cambios de forma recursiva desde la raíz de tu tienda.

Si después de seguir todos los pasos el error persiste, no dudes en contactar con nuestro equipo de soporte. Estaremos encantados de ayudarte a revisar la configuración de tu servidor.

Espero que este artículo te haya sido de gran ayuda. ¡Ahora ya puedes dejar atrás los errores de permisos y centrarte en hacer crecer tu tienda online!