Corregir permisos de archivos en PrestaShop en Syspanel

¿Por qué aparecen errores de permisos en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con algún mensaje como "Error al escribir en la carpeta /cache", "No se puede crear el archivo de log" o "Error 500: Internal Server Error" al intentar acceder a tu tienda PrestaShop. No te preocupes, es un problema muy común. La mayoría de estas errores PrestaShop se deben a una configuración incorrecta de los permisos archivos en tu servidor.

En este artículo, te explicaré paso a paso cómo solucionar los problemas de permisos en PrestaShop usando Syspanel (la herramienta de gestión de hosting que antes se llamaba HestiaCP, y que se accede por el puerto 2106). No necesitas ser un experto en Linux; solo sigue las instrucciones y tu tienda volverá a funcionar.

¿Qué son los permisos de archivos y por qué importan?

En un servidor Linux, cada archivo y carpeta tiene tres tipos de permisos:

Lectura (r): Permite ver el contenido.
Escritura (w): Permite modificar o eliminar el archivo.
Ejecución (x): Permite ejecutar el archivo (como un script).

Además, estos permisos se asignan a tres roles:

Propietario (u): Normalmente el usuario que creó el archivo.
Grupo (g): Un grupo de usuarios con acceso compartido.
Otros (o): El resto de usuarios del sistema.

PrestaShop necesita permisos específicos para funcionar correctamente. Por ejemplo, las carpetas de cache, logs, uploads y configuraciones deben poder ser escritas por el servidor web (Apache/Nginx). Si estos permisos no están bien asignados, aparecerán los temidos errores PrestaShop.

¿Cómo acceder a Syspanel para gestionar los permisos?

Antes de empezar, necesitas entrar a tu panel de control. Syspanel es la herramienta que usamos para administrar tu hosting. Para acceder:

Abre tu navegador y escribe la dirección de tu servidor seguida de :2106. Por ejemplo: https://tudominio.com:2106.
Inicia sesión con tus credenciales (usuario y contraseña que te proporcionamos).
Una vez dentro, busca la sección de "Archivos" o "File Manager". También puedes usar el acceso directo a la base de datos y dominios, pero para permisos usaremos el administrador de archivos.

[TIP] Si no recuerdas tu contraseña de Syspanel, puedes solicitar un restablecimiento desde la misma pantalla de inicio de sesión.

Solución paso a paso para corregir permisos en PrestaShop

Vamos a resolver el problema. Sigue estos pasos en orden. Si saltas alguno, podrías no solucionar el error.

1. Identifica la carpeta raíz de tu PrestaShop

En Syspanel, ve a "Web" o "Dominios" y busca el dominio donde tienes instalado PrestaShop. Haz clic en el nombre del dominio y verás la ruta de la carpeta raíz (normalmente algo como /home/usuario/web/tudominio/public_html).

2. Usa el Administrador de Archivos de Syspanel

Desde el panel lateral, selecciona "Archivos" y navega hasta la carpeta raíz de tu PrestaShop. Verás todas las carpetas y archivos de tu tienda.

3. Aplica los permisos correctos con chmod

El comando chmod (change mode) es la herramienta estándar en Linux para cambiar permisos. En Syspanel, puedes hacerlo desde el administrador de archivos:

Selecciona la carpeta raíz (la que contiene carpetas como admin, cache, img, modules, etc.).
Busca la opción "Permisos" o "Cambiar permisos" (suele ser un icono de candado o un menú contextual al hacer clic derecho).
Se abrirá una ventana donde puedes establecer los permisos numéricos.

Los permisos recomendados para PrestaShop son:

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

Excepciones importantes:

La carpeta config debe tener permisos 755.
Las carpetas cache, log, upload, download, img, mails, modules, themes, translations y sitemap deben ser 755 (a veces 777 si hay problemas de escritura, pero intenta primero con 755).
El archivo settings.inc.php (dentro de config) debe ser 644.

[WARNING] No pongas permisos 777 a todo el sitio. Es inseguro y puede exponer tu tienda a ataques. Solo usa 777 temporalmente si es estrictamente necesario y luego revierte a 755.

4. Cambia el propietario de los archivos (si es necesario)

A veces, aunque los permisos estén bien, el propietario de los archivos no es el usuario correcto. En Syspanel, en el administrador de archivos, puedes cambiar el propietario desde la misma opción de permisos o desde "Propiedades". El propietario debe ser el usuario de tu hosting (el mismo con el que iniciaste sesión en Syspanel) y el grupo debe ser www-data o el grupo del servidor web (consulta con tu soporte si no estás seguro).

5. Verifica la configuración de PHP y el servidor web

Si después de ajustar permisos sigues viendo errores PrestaShop, puede que el problema no sea solo de archivos. Comprueba:

PHP: En Syspanel, ve a "Servidores" > "PHP" y asegúrate de que la versión de PHP sea compatible con tu PrestaShop (por ejemplo, PrestaShop 1.7 requiere PHP 7.1-8.1).
Modo seguro (safe_mode): Debe estar desactivado. En la configuración de PHP de Syspanel, busca "safe_mode" y ponlo en "Off".
open_basedir: Si está activo, puede restringir el acceso a ciertas carpetas. Desactívalo o configura las rutas correctas.

6. Limpia la caché de PrestaShop

Después de cambiar permisos, limpia la caché de PrestaShop para que los cambios surtan efecto:

Ve a tu panel de administración de PrestaShop (ej: tudominio.com/admin1234).
En el menú superior, ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en "Limpiar caché" (tanto la de Smarty como la de la aplicación).

Si no puedes acceder al panel de administración, borra manualmente las carpetas cache/smarty/cache y cache/smarty/compile desde el administrador de archivos de Syspanel. Asegúrate de no borrar los archivos .htaccess que puedan estar dentro.

Preguntas frecuentes (FAQ)

¿Qué hago si después de todo sigo teniendo errores?

Prueba a restablecer los permisos de todo el directorio de PrestaShop desde la línea de comandos. En Syspanel, puedes abrir una terminal (busca "Terminal" en el menú) y ejecutar:

find /home/usuario/web/tudominio/public_html -type d -exec chmod 755 {} \;
find /home/usuario/web/tudominio/public_html -type f -exec chmod 644 {} \;
chmod 755 /home/usuario/web/tudominio/public_html/config
chmod 755 /home/usuario/web/tudominio/public_html/cache

Reemplaza /home/usuario/web/tudominio/public_html con tu ruta real.

¿Puedo usar permisos 777 para todas las carpetas?

No es recomendable. 777 permite que cualquier usuario del sistema (incluyendo posibles atacantes) escriba en tus archivos. Úsalo solo temporalmente para pruebas y luego revierte a 755.

¿Cómo sé qué usuario es el propietario correcto?

En Syspanel, al crear un dominio, se asigna automáticamente un usuario. Normalmente es el mismo que usas para iniciar sesión en el panel. Si tienes dudas, mira en "Web" > "Dominios" > tu dominio > "Propiedades" y verás el usuario.

¿Los permisos afectan a las imágenes que no se cargan?

Sí. Si las imágenes de productos no se muestran, es probable que la carpeta img no tenga permisos de escritura. Cambia sus permisos a 755 y luego regenera las miniaturas desde el panel de administración (Parámetros avanzados > Imágenes > Regenerar miniaturas).

¿Qué hago si aparece "Error 500" después de cambiar permisos?

Revisa el archivo config/settings.inc.php. Si tiene permisos 644, puede que PrestaShop no pueda escribirlo. Temporalmente ponlo en 666 (solo para que el servidor web pueda escribir) y luego vuelve a 644. También verifica que el archivo no tenga errores de sintaxis.

Consejos finales para evitar problemas futuros

Actualiza PrestaShop regularmente: Las versiones antiguas pueden tener vulnerabilidades que causen errores de permisos.
Haz copias de seguridad: Antes de cambiar permisos masivamente, respalda tu tienda desde Syspanel (sección "Backup").
Usa un entorno de pruebas: Si no estás seguro, prueba los cambios en un subdominio o copia local.
Contacta a soporte: Si después de todo esto el problema persiste, puede que sea un error de configuración del servidor. En Syspanel, abre un ticket de soporte desde el menú "Ayuda" o "Tickets".

[INFO] Recuerda que Syspanel es tu aliado. Su administrador de archivos y terminal te permiten gestionar todo sin necesidad de ser un experto en Linux. Si te pierdes, siempre puedes pedir ayuda.

Espero que esta guía te haya sido útil. Los problemas de permisos archivos en PrestaShop son molestos, pero con estos pasos deberías poder resolverlos en pocos minutos. ¡Buena suerte con tu tienda!