Permisos PrestaShop Syspanel - Solución rápida

¿Tu tienda PrestaShop está mostrando errores extraños? ¿No puedes subir imágenes, instalar módulos o incluso acceder al back office? Es muy probable que estés enfrentando uno de los problemas más comunes: errores de permisos en archivos y carpetas. No te preocupes, es algo habitual y tiene solución.

En esta guía completa, te explicaré paso a paso cómo resolver estos problemas utilizando Syspanel (el panel de control de tu servidor, que antes se conocía como HestiaCP y al que accedes por el puerto 2106). Aprenderás a diagnosticar, corregir y prevenir los molestos errores permisos PrestaShop de forma sencilla, sin necesidad de ser un experto en servidores.

¿Por qué aparecen los errores de permisos en PrestaShop?

PrestaShop, como cualquier aplicación web, necesita permisos específicos para leer, escribir y ejecutar archivos en tu servidor. Cuando estos permisos no son los correctos, la tienda falla.

Los problemas más típicos incluyen:

Imágenes que no se suben o aparecen rotas.
Módulos que no se instalan o actualizan.
El back office (panel de administración) no carga o da errores en blanco.
El front office (tu tienda) se ve sin estilos (CSS) o con errores de JavaScript.
Imposibilidad de generar archivos de caché o de traducción.

La causa principal suele ser una mala configuración de permisos después de migrar la tienda, al instalar un módulo conflictivo, o simplemente porque el servidor tiene una configuración predeterminada que no es compatible con PrestaShop.

Entendiendo los permisos: el "quién" y el "qué"

Antes de meternos en la solución, es útil entender dos conceptos clave. No te asustes, es más sencillo de lo que parece.

El Usuario: ¿Quién es el dueño de los archivos?

En tu servidor, los archivos tienen un propietario y un grupo. Piensa en ello como la propiedad de una casa.

Propietario (Owner): Es el usuario del sistema que creó el archivo. Normalmente, el usuario de tu cuenta de hosting.
Grupo (Group): Un conjunto de usuarios que pueden tener ciertos permisos sobre el archivo.

En un entorno de hosting compartido o administrado con Syspanel, el usuario de FTP y el usuario del servidor web (normalmente www-data o nobody) suelen ser diferentes. El conflicto surge cuando los archivos son propiedad del usuario FTP, pero el servidor web necesita escribir en ellos. La solución es que el grupo de los archivos sea el del servidor web.

Los Permisos: ¿Qué puede hacer cada quién?

Los permisos se representan con números (como 755 o 644) o con letras (rwx). Cada número o letra define tres acciones:

r (4): Leer (Read).
w (2): Escribir (Write).
x (1): Ejecutar (Execute).

Estos permisos se asignan a tres niveles:

Usuario (Owner): Lo que puede hacer el propietario.
Grupo (Group): Lo que puede hacer el grupo.
Otros (Others): Lo que puede hacer cualquier otro usuario.

Para PrestaShop, la configuración mágica es:

Carpetas: 755 (rwx r-x r-x). El propietario puede hacer todo; el grupo y otros pueden leer y ejecutar.
Archivos: 644 (rw- r-- r--). El propietario puede leer y escribir; el grupo y otros solo pueden leer.

Solución paso a paso con Syspanel

Ahora sí, vamos a corregir los permisos PrestaShop Syspanel de manera segura y efectiva. Sigue estos pasos al pie de la letra.

Paso 1: Accede a Syspanel

Abre tu navegador y escribe la dirección de tu servidor seguida del puerto 2106. Por ejemplo: https://tudominio.com:2106 o https://la-ip-de-tu-servidor:2106. Inicia sesión con tu usuario y contraseña de administrador.

Paso 2: Localiza tu dominio y el gestor de archivos

Una vez dentro, busca la sección Web o Sitios Web. Verás una lista de los dominios que tienes alojados. Haz clic en el nombre del dominio donde está instalada tu tienda PrestaShop.

Dentro de la configuración del dominio, busca un icono o enlace que diga Gestor de Archivos o File Manager. Es posible que también se llame Explorador de Archivos. Haz clic para abrirlo.

Paso 3: Navega hasta la raíz de PrestaShop

El gestor de archivos te mostrará el contenido de tu sitio web. Busca la carpeta donde instalaste PrestaShop. Normalmente se llama public_html o es el nombre de tu dominio. Dentro de ella, deberías ver las carpetas clásicas de PrestaShop: admin, img, modules, themes, var, etc.

Paso 4: Aplica los cambios de permisos (¡La parte clave!)

Aquí es donde ocurre la magia. Vamos a corregir los permisos de forma masiva. No lo hagas archivo por archivo, sería eterno.

Selecciona todo: En la parte superior del gestor de archivos, busca una casilla de verificación que seleccione todos los archivos y carpetas de la raíz de PrestaShop. Márcala.
Cambiar permisos: Busca un botón que diga Permisos, Cambiar permisos, Chmod o un icono de candado. Al hacer clic, se abrirá una ventana.
Configura los permisos para ARCHIVOS:
- Verás tres columnas para el propietario, el grupo y otros.
- Marca las siguientes casillas:
  - Propietario: Lectura, Escritura. (No marques Ejecución).
  - Grupo: Lectura. (No marques Escritura ni Ejecución).
  - Otros: Lectura. (No marques Escritura ni Ejecución).
- En la parte inferior, verás un campo numérico. Debería marcar 644.
- IMPORTANTE: Busca una opción que diga "Aplicar solo a archivos" o "Recursivo solo a archivos". ¡Selecciona esta opción! No queremos cambiar los permisos de las carpetas ahora.
- Haz clic en Aceptar o Guardar.
Configura los permisos para CARPETAS:
- Repite el proceso: selecciona todo de nuevo y haz clic en Permisos.
- Ahora marca las siguientes casillas:
  - Propietario: Lectura, Escritura, Ejecución.
  - Grupo: Lectura, Ejecución. (No marques Escritura).
  - Otros: Lectura, Ejecución. (No marques Escritura).
- El campo numérico debería marcar 755.
- IMPORTANTE: Ahora busca la opción "Aplicar solo a carpetas" o "Recursivo solo a directorios". ¡Selecciona esta opción!
- Haz clic en Aceptar.

[WARNING]
No apliques permisos 777 (todos los permisos a todos) en toda la tienda. Es un grave error de seguridad que deja tu tienda expuesta a ataques. Solo se usa en casos muy concretos y temporales.
[/WARNING]

Paso 5: Ajusta el propietario y grupo (si es necesario)

A veces, los permisos correctos no son suficientes si el propietario o el grupo no son los adecuados. En Syspanel, esta configuración suele estar en la sección del dominio, a menudo en una pestaña llamada Configuración avanzada o Opciones del sitio.

Busca una opción que permita cambiar el Usuario del sistema o el Grupo del sistema para los archivos del dominio. Si ves algo como Propietario: usuario y Grupo: www-data, es perfecto. Si no, intenta cambiarlo.

Regla de oro:

El propietario debe ser tu usuario de FTP (el que usas para subir archivos).
El grupo debe ser el del servidor web, normalmente www-data.

Si no ves esta opción en Syspanel, no te preocupes. El paso 4 suele resolver el 90% de los problemas.

Paso 6: Limpia la caché de PrestaShop

Después de cambiar los permisos, es fundamental limpiar la caché de PrestaShop para que los cambios surtan efecto.

Accede a tu Back Office de PrestaShop (si puedes, si no, tendrás que hacerlo manualmente desde el gestor de archivos).
Ve a Parámetros Avanzados > Rendimiento.
Haz clic en el botón Limpiar caché (tiene un icono de una escoba).

[TIP]
Si no puedes acceder al Back Office, limpia la caché manualmente desde Syspanel. En el gestor de archivos, borra todo el contenido de la carpeta /var/cache/ de tu PrestaShop (normalmente public_html/var/cache/). No borres la carpeta en sí, solo su contenido.
[/TIP]

Soluciones a problemas específicos

A veces, los pasos generales no bastan. Aquí tienes soluciones para casos concretos.

Error al subir imágenes

Si después de todo sigues sin poder subir imágenes, el problema suele ser la carpeta img.

Ve a la carpeta img en el gestor de archivos.
Selecciona todas las subcarpetas (como p, c, s, etc.).
Aplica permisos 755 a estas carpetas (solo a las carpetas).
Aplica permisos 644 a los archivos dentro de ellas (solo a los archivos).

Error al instalar módulos o actualizar la tienda

Los módulos y las actualizaciones necesitan escribir en varias carpetas. Además de los pasos generales, asegúrate de que estas carpetas tengan permisos 755 (no 644):

/modules
/themes
/override
/translations
/download
/upload
/config (a veces es necesario darle 755 temporalmente para una actualización).

[INFO]
Una práctica segura es, después de instalar o actualizar, volver a dejar las carpetas del módulo en 755 y los archivos en 644. No dejes nada en 777.
[/INFO]

Pantalla en blanco (WSOD - White Screen of Death)

Si ves una pantalla completamente blanca, es un error grave de PHP o permisos. Los pasos anteriores suelen resolverlo. Si no, prueba esto:

Desde el gestor de archivos, ve a la carpeta /config.
Busca el archivo defines.inc.php.
Ábrelo para editarlo.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga tu tienda. Ahora verás el error real en lugar de la pantalla en blanco. Eso te dará pistas sobre qué archivo o carpeta tiene el problema.

FAQ: Preguntas frecuentes sobre permisos PrestaShop Syspanel

P: ¿Cada cuánto debo revisar los permisos de mi PrestaShop?
R: No es necesario hacerlo a menudo. Solo después de una migración, una actualización grande del núcleo, o si empiezas a ver errores extraños. Una vez al año como mantenimiento preventivo está bien.

P: ¿Es seguro usar el gestor de archivos de Syspanel?
R: Sí, es tan seguro como usar un cliente FTP como FileZilla. De hecho, es más seguro porque no expones tus credenciales FTP a un programa externo. Eso sí, siempre cierra la sesión de Syspanel cuando termines.

P: ¿Qué hago si después de todo sigo teniendo errores?
R: A veces el problema no son los permisos de archivos, sino la configuración del servidor web (Apache o Nginx). En ese caso, contacta con tu proveedor de hosting y diles que necesitas que el grupo de tus archivos sea www-data y que el servidor web pueda escribir en las carpetas de PrestaShop. Muéstrales esta guía si es necesario.

P: Cambié los permisos a 777 y ahora mi tienda está lenta o tiene inyecciones de código. ¿Qué hago?
R: ¡Has cometido un error de seguridad! Vuelve a aplicar inmediatamente los permisos 755 a carpetas y 644 a archivos siguiendo el Paso 4. Después, escanea tu tienda con un antivirus (como el módulo de PrestaShop o una herramienta externa) para asegurarte de que no se haya subido ningún archivo malicioso. Considera cambiar todas tus contraseñas.

P: No encuentro la opción de cambiar permisos en Syspanel.
R: La interfaz puede variar ligeramente según la versión de Syspanel. Busca un icono de un candado, una rueda dentada o un menú desplegable que diga "Acciones" o "Más". Si no lo ves, contacta a tu soporte técnico y pregúntales cómo acceder al "chmod" o "cambio de permisos" desde el panel.

Conclusión

Resolver los errores permisos PrestaShop es una de las habilidades más útiles que puedes aprender como dueño de una tienda online. Con Syspanel y esta guía, ya tienes las herramientas para diagnosticar y solucionar el problema tú mismo, ahorrándote tiempo y llamadas al soporte técnico.

Recuerda siempre la regla de oro: 755 para carpetas, 644 para archivos. Aplica estos cambios con cuidado, limpia la caché, y tu tienda volverá a funcionar como un reloj. ¡Manos a la obra!